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PREFACE 



This manual describes the software of the AMPL* Microprocessor Prototyping Laboratory and 
the hardware installation of the emulator and buffer module and the logic-state trace data 
module which support the prototyping laboratory. The manual also describes the AMPL language 
in detail, and includes examples of the use of the laboratory to debug hardware and software. 

The manual is organized into seven sections and eight appendixes including: 

I General Description - Provides a general description of the prototyping laboratory and 
its hardware and software components. Also describes the prototype development 
cycle. 

II System Hardware Installation - Describes the hardware configuration of the laboratory 
in detail, including interconnection information. 

III AMPL Applications - Describes the use of the AMPL language in development of the 
hardware of a prototype system. 

IV AMPL Microprocessor Prototyping Language - Describes the AMPL language in detail. 

V System Operation - Includes operating instructions for AMPL software and description 
of the user commands. 

VI Errors and Recovery - Describes the error and warning message formats and lists the 
error messages and recovery procedures. 

VII Examples - Includes examples of the use of the AMPL language in developing the 
software of a prototype system. 

A TX900 System Generation - Describes the generation of a custom TX990 for prototyp- 
ing laboratory. 

B DXIO System Generation ^ Describes the generation of a custom DXIO for prototyping 
laboratory. 

C AMPL Grammar - The formal definition of the AMPL grammer. 

D AMPL Statement Summary — A summary of the AMPL statements. 

E AMPL Reserved Words - A list of the reserved words of the AMPL language. 

F System Symbols - A list of the system variables of the AMPL system. 

G User Commands - A summary of the AMPL user commands. 
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H AMPL Procedure and Function Library - Descriptions of the procedures and functions 
of the AMPL Procedure and Function Library. 



I Glossary - A glossary of terms used in tne manual. 
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SECTION I 
GENERAL DESCRIPTION 



1.1 INTRODUCTION 

The AM PL Microprocessor Prototyping Laboratory is a powerful tool for developing microprocessor 
systems. The laboratory contributes significantly to the development of both software (or firmware) 
and a hardware prototype. A prototyping laboratory includes the following: 

• A Model 990 Computer and operating system with dual floppy disks or a moving-head disk. 

• A hardware Emulator with TMS 9900 Buffer Module or TMS 9980 Buffer Module. 

• A hardware Logic-State Trace Data module for the prototype system. 

• A set of user commands for debugging the prototype system and its software. 

• AM PL Microprocessor Prototyping Language to support user commands. 

The operating system supplied for the Model 990 Computer equipped with floppy disks is the Terminal 
Executive (TX990). It supports the Terminal Executive Development System (TXDS) that includes 
the Text Editor, Assembler, and Link Utility. The computer, TX990, and floppy disks also support the 
AM PL program which implements the user commands. Floppy disk units provide the user with a high- 
speed, random access storage medium on which the user can develop programs using the Text Editor, 
Assembler, and Link Utility. In addition, the debugging environment (including prototype programs) 
can be saved on and restored from diskette files. 

The operating system supplied with the DS990 disk system is the Disk Executive, DX 10, Release 3. It 
supports program development utilities including a text editor, a macro assembler, a FORTRAN 
compiler, a COBOL language processor, a BASIC* interpreter, and a link editor. The computer, 
DX 10, and the disk system also support the A M PL program that implements the user commands. The 
disk system provides the user with a high-speed, random access storage medium on which the user can 
develop programs using the program development capabilities. In addition, the debugging 
environment (including prototype programs) can be saved on and restored from disk files. 

The emulator hardware includes a buffer module for the microprocessor to be used in the user's 
prototype system (target system). The emulator with the appropriate buffer module replaces the 
microprocessor of the target system. The emulator also provides memory and control circuitry 
required to execute software in the target system under control of the AM PL software. The emulator 
memory consists of a 256-word trace memory and a 4K-word user memory. The control circuitry 
allows the emulator to halt processing on specified program conditions (breakpoints) and to store 
memory or instruction addresses in the trace memory. The host computer (Model 990 Computer in 
which AM PL software executes) can halt the emulated microprocessor and access and modify 
memory in the target system. 

The trace module contains a 256 by 20-bit memory that stores up to 256 20-bit words that can be read 
by the host computer. The 20 bits may be connected to the address or memory bus through the 
emulator module or directly to test points in the target system using data probes. Four of the lines are 
equipped with latches that can change state on fast pulses as narrow as approximately 10 ns duration. 
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Four qualifier lines select data words to be traced, and an event counter counts traced words that 
match a specified data word. Both the qualifiers and the data are masked to allow the user to specify 
any qualifiers and data bits to be used in the selection. The event counter, together with the delay 
counter, generates a signal that may be used to terminate the trace. Alternatively, a signal that the trace 
memory is full may be used to terminate the trace. Termination of the trace may either interrupt the 
host computer or signal the emulator to halt the microprocessor. 

1.2 TYPICAL PROTOTYPE DEVELOPMENT CYCLE 

Figure 1-1 shows the use of the laboratory during development of the software and integration of 
software into the prototype system. First, the software development capabilities executing in the host 
computer are used to obtain an object module. The source code is prepared and assembled using the 
text editor and assembler. When assembler errors are detected, the text editor is used to correct the 
source code and the source code is reassembled. When all errors that the assembler can detect have 
been corrected, the resulting object module is linked with other required object modules, if any, to 
obtain a linked object module. Source code for one or more modules may be corrected and 
reassembled if the link utility detects an error. When the linking operation detects no errors, the linked 
object module is ready to be loaded into memory of the target system. Alternatively, the module may 
be loaded into user memory or trace memory of the emulator module as appropriate. 

The user may enter commands and A M PL statements to initialize trace and breakpoint conditions for 
testing the software and prototype system, and to start the emulator. When a breakpoint halts the 
emulator, the user may enter commands to inspect the results of the test. When the results are not 
correct, the user may correct the source code, reassemble and relink. Or the user may make corrections 
in the object code in target system memory. The user may also continue testing until the prototype 
system is thoroughly tested, and all areas of the software have been executed. When the software has 
been thoroughly tested, the user may execute the PROM Programmer Utility to manufacture 
firmware. 

1.3 OPERATIONAL FEATURES 

Figure 1-2 shows an AM PL configuration consisting of a trace module and an emulator module under 
control of a host computer connected to a target system by cables from the buffer module and from the 
trace module. The buffer module cables connect to the microprocessor socket in the target system, and 
the trace module cables connect to signals being traced in the target system. 

The lab provides the following operational features: 

• The user may load the target program into emulator memory or target memory or a 
combination of both. 

• The user substitutes the emulator for the microprocessor in the target system, and thus 
monitors the flow of execution of the target program in the target system. 

• The host processor monitors interrupts from both the emulator module and the trace 
module(s). 

• The user may inspect and modify the contents of memory and registers in the target system, 
the emulator module, and the trace module(s). 

• The user may save and restore the environments of debug sessions to continue the debug 
operation at a later time. 

• The user may enter user commands to control the debug operation. 
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Figure 1-1. Typical Prototype Development Cycle 
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1 .4 SOFTWARE CONFIGURATION 

Software required for the laboratory system is as follows: 

• AMPL Software 

• PROM Programmer Utilities 

For a TX990 system, the additional software is: 

• TX990 Operating System 

• TXDS Development System 

• TXMIRA Assembler 

• TXEDIT Text Editor 

• TXLINK Link Utility 

• TXLNK Link Editor Utility 

For a DXIO system, the additional software is: 

• DXIO Operating System 

• SDSMAC Macro Assembler 

• SDSTIE Text Editor 

• SDSLNK Link Editor 
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SECTION II 
SYSTEM HARDWARE INSTALLATION 

2.1 GENERAL 

This section provides instructions for site planning, installation, and initial checkout ot the 
emulator buffer modules and the logic-state trace data module when employed with either a FS99() or 
DS990 system for TMS 9900 or TMS 9980 microprocessor hardware and software development. 

2.1.1 SYSTEM CONFIGURATION. A typical AMPL Microprocessor Prototyping Laboratory is 
shown in figure 2-1. Several options of peripheral equipment are available for use with the system to 
assist with checkout and debug of the target system. In all cases the trace module and the emulator 
are installed in the Model 990 Computer chassis (990/4 or 990/10. or an expander chassis) and are 
cabled in one of several alternate configurations to suit the target system under test, in figure 2-1. 
the microprocessor connector from the buffer module is installed in the target system in place of 
the microprocessor; the other cables from the buffer module arc connected to the emulator module 
installed in the 990 computer chassis. 

2.1.2 SYSTEM COMPONENTS. Typical components of an AMPL Microprocessor Prototyping 
Laboratory are shown in figure 2-2. 1 he trace module and the emulator module are shown installed in 
a Model 990 Computer chassis. Optional connections to the target system are: 

1. From the emulator via the buffer module, target connect, and the interconnecting cables. 
Components associated with the emulator are shown in figure 2-3. 

2. From the trace module via the trace data probe cable, the terminator box, and the probe 
leads equipped with either fema'e connector pins or IC test clips. Components associated 
with the trace module are shown in figure 2-4. 

A summary of the components shown in figures 2-3 and 2-4 are listed in table 2-1, along with the 
associated part numbers for each. 

2.2 SYSTEM INSTALLATION 

2.2.1 COMPUTER CHASSIS OPTIONS AND PREPARATIONS 

CAUTION 

Before removing or installing circuit boards and cables, be sure power 
is off since voltage transients can damage components parts. 

The CRU base address that the software uses to address and control the prototyping laboratory system 
is determined by the physical location of the emulator module and the trace module in the 990 
computer chassis, or in a CRU expander chassis. Since there are several different combinations of 
options for these installations, the user and programmer should decide upon the chassis slot locations, 
the CRU base address, and the interrupt level for both of these modules before installing them. 
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Figure 2-2. Typical Prototyping Laboratory Configuration 
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EMULATOR MODULE 
CIRCUIT BOARD 



(A)l 36523 (AMPL-377-35-S) 

Figure 2-3. Emulator/Buffer and Interconnect Cables 



There are four typical FS990 system configurations, two of which use the Model 91 1 Video Display 
Terminal (VDT) and two of which use the Model 913 VDT. Figure 2-5 shows the standard 
configuration, using a Model 990/4 Computer and the Model 91 1 VDT. Figure 2-6 shows the same 
peripherals and a Model 990/ 10 Computer. Figure 2-7 shows the typical configuration using a Model 
990/4 Computer and a Model 913 VDT. Figure 2-8 shows a similar configuration using a Model 
990/ 10 Computer with the same peripherals. If the prototyping laboratory system is received with the 
modules installed in the standard configurations, the CRU base addresses have been established at the 
factory and are compatible with the software package. Also, in that case, the correct interrupt levels 
have been determined and prewired in the interrupt jumper plugs for the peripherals. No alterations or 
modifications of the 990 computer chassis is required. Other configurations are available from Texas 
Instruments to modify existing FS990 systems to suit user requirements. 

A DS990 system that supports the AMPL laboratory requires a Model 990/10 Computer 13-slot 
chassis with a disc drive system. The Model 91 1 VDT controller, emulator, and trace module may be 
installed in the main chassis as shown in figure 2-9, or in a CRU expansion chassis. The main chassis 
configuration for use with an expansion chassis is shown in figure 2-10, and the expansion chassis is 
shown in figure 2-1 1 . A 91 1 VDT for another work station may be connected to the controller board, 
and the emulator and trace modules for the station may be installed in slots 12 and 13. 

If the prototyping laboratory system is received with the modules installed in the recommended 
computer configuration, the CRU base addresses for the modules in the computer chassis have been 
estabUshed at the factory and are compatible with the software package. Also, in that case, the correct 
interrupt levels have been determined and prewired in the interrupt jumper plugs. The CRU base 
addresses of the modules in the expansion chassis are determined by the plug on the CRU expander 
board to which the chassis is connected, and the slots into which the modules are connected. The 
interrupt levels are prewired in the interrupt jumper plug. 
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CONTROL 
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Figure 2-4. Trace Module, Trace Data Probe, and Interconnect Cables 
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Table 2-1. AMPl, Microprocessor Prototyping Laboratory 



Component 



Part Number 



Emulator Module 

IMS 9900 Buffer Assembly 
Emulator/ Buffer Cable 
Emulator/ Buffer Cable 
Buffer/ Target Cable 
Buffer/ Target Cable 
Buffer/ Target Clock Cable 
TMS 9900 Target Connector 
TMS 9900 Buffer Module 

TMS 9980 Buffer Assembly 
Emulator Buffer Cable 
Emulator/ Buffer Cable 
Buffer/ Target Cable 
Buffer/ Target Cable 
TMS 9980 Target Connector 
TMS 9980 Buffer Module 

Trace Module 

Emulator/ Trace Data Cable 
Emulator/ Trace Control Cable 

Trace Data Probe 



949925-0001 
949937-0001 
949924-0001 
949924-0002 
949923-0001 
949923-0002 
949945-0001 
949905-0001 
949995-0001 
949937-0002 
949924-0001 
949924-0002 
949923-0003 
949923-0004 
949955-0001 
949940-0001 
949910-0001 
949935-0001 
949936-0001 
949915-0001 



CHASSIS 

SLOT 
NUMBER 

1 

2 
3 
4 
5 
6 

7 
8 
9 
1 
1 1 
1 2 
1 3 

(A)1 37447 
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N/A 
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N/A 
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EXPANSION (OPT. ) 


N/A 


0280 


8K 990/4 MEMORY 
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TRACE MODULE 


6 


0100 


TRACE MODULE 


6 


OOEO 
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CONTROLLER 
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3 
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FLOPPY DISC 
CONTROLLER 


7 


OOBO , 


FLOPPY DISC 
CONTROLLER 


7 


0060 


LINE PRINTER 
(OPTIONAL) 


6 


0040 


CARD READER 
(OPTIONAL) 


4 


00 20 


PROM PROGRAM- 
MER (OPTIONAL) 


6 


0000 


733 ASR 
(OPTIONAL) 


6 



Figure 2-5. Model 990/4 Computer 13-Slot Chassis, Standard Configuration, 
TX990 with 911 VDT 
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5 

6 

7 

8 

9 
10 
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1 3 
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CONTROLLER 


7 


0080 


FLOPPY DISC 
CONTROLLER 
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6 


0040 
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4 


0020 


PROM PROGRAM- 
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6 


0000 


7 33 ASR 
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Figure 2-6. Model 990/10 Computer 13-Slot Chassis Configuration for TX990 with 91 1 VDT 
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EXPANSION (OPT.) 


N/A 


28 


8K 990/4 MEMORY 
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Figure 2-7. Model 990/4 Computer 13-Slot Chassis Configuration for TX990 with 913 VDT 



2-7 



Digital Systems Division 




946244-9701 



CHASSIS 

SLOT 
NUMBER 



6 

7 

8 

9 
10 
1 1 
1 2 
1 3 
(A)1 37450 



P2 



CRU 

BASE 

ADDRESS 
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990/10/AU2 
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Figure 2-8. Model 990/10 Computer 13-Slot Chassis Configuration for TX990 with 913 VDT 
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TRACE MODULE 


7 


0060 


LINE PRINTER 
(OPTIONAL! 


1 4 


0040 


CARD READER 
rOPTIONAL) 


4 


0020 


PROM PROGRAM- 
MER (OPTIONAL) 


1 5 


0000 


733 ASR 
(OPTIONAL) 


6 



Figure 2-9. Model 990/10 Computer 13-Slot Chassis Recommended DXIO Configuration 

without CRU Expansion Chassis 
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EXPANSION 


N/A 


0260 


48K MEMORY 
EXPANSION 
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EXPANSION 


N/A 


0200 


16K MEMORY 
EXPANSION 
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Figure 2-10, Model 990/10 Computer 13-Slot Chassis Recommended DXIO Configuration with 

CRU Expansion Chassis 
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note: the CRU base addresses SHOWN APPLY TO EXPANSION CHASSIS 1 (CONNECTED 
TO P3 OF CRU EXPANDER BOARD). ADD (N • 1 ) M 400,6 TO THE ABOVE ADDRESSES 
FOR CRU BASE ADDRESSES IN EXPANSION CHASSIS N. 



Figure 2-11. Model 990/10 Computer 13-Slot CRU Expansion Chassis Recommended DXIO Configurat 
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2.2.1.1 Interrupt Levels. If the trace and emulator modules are obtained as separate kits to be installed 
in an existing computer system, new interrupt level connections must be made in the computer chassis 
and in the expansion chassis for proper interrupt recognition by the program. 



CAUTION 



Ensure that ac power to the computer chassis has been disabled before 
beginning this procedure. 



2.2.1.2 Interrupt Connections and Modifications. Wiring in the backplane of the chassis connects 
interrupt lines from each circuit board connector to a pair of jumper plugs located on the backplane 
adjacent to slot number 1 , as shown in figure 2- 1 2. Jumper wires installed in these jumper plugs connect 
the interrupt output lines from the circuit boards to the CRU interrupt inputs. In the expansion 
chassis, similar plugs connect the interrupt output lines from the circuit boards to the interrupt inputs 
of the CRU buffer module. 

Figure 2-13 is an outline drawing of the jumper plugs for the 1.5-slot chassis and the 6-slot chassis. 
Interrupt levels are shown at the right of each connector. The 990/4 computer does not recognize 
interrupt levels 8 through 15. Twojumper positions are wired to each chassis interrupt line. This allows 
multiple interrupts to be connected to one interrupt level. To make interrupt level modifications 
perform the following steps: 

1. Remove the circuit boards from the first five slots of the chassis to gain access to the 
interrupt jumper plugs. 



IN ERRUPT JUMPER PLUGS 




REMOVE CIRCUIT BOARDS IN FIRST FIVE 
LOCATIONS FOR ACCESS TO JUMPER PLUGS 



(A)133096A 



Figure 2-12. Location of Interrupt Jumper Plugs (6— and 13— Slot Chassis) 
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Figure 2-13. 6- and 13- Slot Chassis Interrupt Jumper Plugs 
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2. Use one of the following steps to connect the jumper wires. 

a. Pluggable jumpers. Remove the jumper plugs from the chassis. Insert the specially- 
constructed jumper wire to connect the interrupt level to the chassis slot interrupt pin. 

b. Jumper pins. Connect a jumper wire from the interrupt level pin to the chassis slot 
interrupt pin. 

3. Reinstall the jumper plugs and then reinstall the circuit boards. 

For additional information about interrupt connections, refer to the Model 990 1 4 Computer System 
Hardware Reference Manual or the Model 990/10 Computer System Hardware Reference Manual. 

1.12 CIRCUIT BOARD INSTALLATION. When the proper locations in the computer chassis for 
the emulator and trace modules have been determined and the correct interrupt levels established, 
install the modules in the computer chassis in the following manner: 

1 . Ensure that computer power is off. 

2. Insert the circuit board, component side up, into the selected slot so the board slides into the 
card guides on either side of the slot. 

3. Push the board straight in until the edge connector engages the connector in the backplane. 
Verify that the guide slots in the circuit board mate properly with the alignment comb in the 
chassis. 

2.2.3 CABLE CONNECTIONS. When the circuit boards have been installed in the appropriate 
chassis slot, install the cables for the particular configuration in which they are to be used. The AM PL 
Microprocessor Prototyping Laboratory can utilize one emulator/ buffer as shown in figure 2-14, or 
one trace module as shown in figure 2-20, or both an emulator/ buffer and a trace module as shown in 
figure 2-23. To install a plug/ receptacle, be sure that the embossed arrowheads are aligned for correct 
orientation before mating the pair together, then align the pins, match the connectors together evenly, 
and press on the plug until it is firmly seated. 

NOTE 

Pin 1 of the connector is on the same side as the red stripe on the ribbon 
cable. 

2.2.3.1 Installing Emulator/ Buffer Cables. The emulator works in conjunction with the buffer module 
to replace the microprocessor and/ or the program memory in the user's target system. The buffer 
module houses the microprocessor and completes the interface between the emulator and the target 
system. 

Two ribbon cables are routed from the buffer module to the emulator, and three other ribbon cables 
(two for TMS 9980) are routed between the buffer module and the target connector. The configuration 
of these cable connections is shown in View A and B of figure 2-14. 

Install the cables from the buffer module to the emulator as shown in the illustration. The location of 
the connectors on the emulator module are as shown in figure 2-15. When installing connectors, be sure 
the embossed arrowheads on the 'plug and the receptacle have the same orientation, as shown in figure 
2-16. Since one of the mating connectors is slightly inset on the emulator circuit board, these 
connections should be made before the emulator board is fully inserted into the computer chassis 
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Figure 2-16. Cable Connections at Emulator 



backplane connectors. Attach the emulator/ buffer cable connectors, P5 and P6, to the emulator 
module connectors P5 and P6, respectively, then slide the emulator into the chassis backplane 
connectors. When the backplane connectors are fully engaged, the two plastic ejectors on the outer 
corners of the emulator board should settle in place against the frame. 

2.2,3.2 Installing Target System Connectors. The three cables from the TMS 9900 buffer module are 
installed in the target system connector as shown in figure 2-17. Connect P2 to J2, P3 to J3,and P4to 
J4. Be sure the orientation of the plugs is as shown in the illustration (i.e., the embossed arrowhead on 
the plugs is adjacent to pin 1). 
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Figure 2-17. Installation of Buffer Cables and Connector at TMS 9900 Target System 
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The connections for the TMS 9980 Buffer are similar, as shown in figure 2-18. Connect the two cables 
from the buffer module to the target system connector, P2 to P2, and P3 to P3. No clock cable or 
separate ground connection is required. Be sure the orientation of the plugs is as shown in the 
illustration (i.e., the embossed arrowhead on the plugs is adjacent to pin 1. 

When the system cables have been installed in the target system connector, remove the microprocessor 
chip from the target system breadboard and install the target connector in place of the chip. Be sure the 
beveled index corner of the connector (which identifies pin 1 of the microprocessor chip) has the 
correct orientation, as shown in figure 2-17 and 2-18. 

Next, (TMS 9900 buffer only) connect the ground lead to a good target system ground, preferably near 
the microprocessor socket. 

When all of the connections have been made, insert a slot screwdriver into the cutout of the buffer 
module cover and select either an INTERNAL prototyping system CLOCK or the TARGET SYS 
external clock (figure 2-19). 

2.2.3.3 Installing Trace Module Cables. If a trace module is to be used alone, install the trace data 
probe as shown in figure 2-20. This general-purpose data probe is implemented on a 6-foot ribbon 
cable with an edge connector on one end and a terminator box on the other end. Each of the 26 signal 
channels in this cable (plus two ground leads) are extended from the terminator box via color-coded 
probe leads, as shown in figure 2-2 1 . Each probe lead has a female connector on its outboard end, sized 
to fit a standard wire-wrap post. Special spring-loaded IC test clips that accommodate the probe leads 
are available from suppliers, and these IC test clips may be used for convenient attachment to any IC 
element, as shown in figure 2-22. 

2.2.3.4 Connecting Emulator and Trace Module. The emulator and trace modules are cabled together 
as shown in figure 2-23. The interconnections consist of two, 4-inch jumper cables. The control cable is 
connected P3 to P3, and the data cable is connected P4 to P4. Verify that the embossed arrowheads on 
plugs P3 and P4 are aligned with pin I on connectors P3 and P4. Optionally, the jumper data cable may 
be omitted, if it is desired to trace data patterns directly from the target system. In this case, the trace 
data probe may be connected from the trace module to the target system as described in the preceding 
paragraph. 

2.3 PERIPHERAL EQUIPMENT FOR THE PROTOTYPING LABORATORY 

Many various options of peripheral equipment are available for installation in the AM PL 
Microprocessor Prototyping Laboratory. The most frequently used peripherals in a TX990 system are 
shown in figure 2-24, along with the interface board or controller and the cables for each type of 
equipment. Figure 2-25 shows similar information for a DXIO system. 
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Figure 2-18. Installation of Buffer Cables and Connector at TMS 9900 Target System 
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Figure 2-19. Buffer Module 



1 



Ji 



TO EMULATOR 

► 



2-19 



Digital Systems Division 



J qp \ 946244-9701 




(A) 1 36002 



990 COMPUTER 



TRACE MODULE 
9499 1 



9 4 9 9 15 
TRACE DATA 
PROBE 




TARGET 
SYSTEM 



Figure 2-20. Trace Module Cabling Diagram 
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Figure 2-21 . Trace Data Probe Terminator Box and Leads 
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Figure 2-22. Typical Connections to Target System 
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Figure 2-23. Trace Module and Emulator Module Interconnecting Cable 
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Figure 2-24. Peripheral Devices Available for AMPL 
Microprocessor Prototyping Laboratory (TX990) 
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Figure 2-25. Peripheral Devices Available for AMPL 
Microprocessor Prototyping Laboratory (DXIO) 
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SECTION III 
AMPL APPLICATIONS 

3.1 INTRODUCTION TO AMPL LANGUAGE 

Other parts of this manual describe in detail the syntax and usage of each element in the AMPL 
language. This section brietly outlines some of the capabilities of the language and describes 
some actual applications to development problems. 

The AMPL language is a complete test language which includes: 

integer arithmetic 

logical operators 

arithmetic (two's complement) and unsigned magnitude relation operators 

execution control and branching structures 

procedure and function declarations which facihtate design of routines and subroutines 

library procedures and functions especially designed to facihtate the gathering and 
display of test data 

user-controlled display formats - binary, decimal, hexadecimal, octal, ASCII, and 9900 
assembly language mnemonics 

emulator/buffer control commands 

trace module control commands 

utility functions. 

The AMPL language allows the user to initiate and control each test operation on an interactive 
basis, or to design and store extensive monitoring and testing procedures which execute without 
manual intervention. 

The examples of AMPL apphcations in this section utihze the trace module control commands, 
the emulator control commands, and some of the library procedures. 

The emulator and trace module commands are intimately related to the module hardware and 
the test connections (see Section II before proceeding). Briefly, the emulator and buffer connect 
a substitute microprocessor into the system under test (target system). The Emulator has access 
to all the microprocessor input and output hnes, including the CRU, address bus. data bus. 
memory control, clock and hold hnes. This gives the emulator control of the target system, and 
access to the Program Counter (PC), Workspace Pointer (WP), and Status Register (ST). 
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3..1.1 EMULATOR CONTROL COMMANDS AND VARIABLES. The emulator module must be 
initialized before any type of emulator aecess may be exeeuted. The HINT command i^itiali/e^ 
the emulator, specifying by device name which emulator is active. The HINT command is entered 
as follows: 

EINT ('EMU') Initialize emulator EMU. 

The example uses a TX990 device name. The proper command for a DXIO system is as follows: 
EINT CEMOP) Initialize emulator EMOl. 

Selection gates, controlled by a system variable EUM, allow the microprocessor access to a 8K-byte 
emulator user memory or to the target system memory. The emulator has a 512-byte memory which 
may be assigned to the microprocessor or reserved for address tracing, as specified by a system variable 

ETM. 

The emulator has comparison logic which monitors the address bus. the Data Bus In (DBIN) line 
and the Instruction Acquisition (lAQ) line and gives a comparison output when they match ^a 
predetermined value. This predetermined value is controlled by the emulator compare (liCMP) 
command. The ECMP command has an address field which selects the address to be checked, 
and a type field which determines whether the compare should be issued for instruction 
acquisitions only, write operations only, or all accesses to the specified address. The type field 
can also be used to disable comparisons. 

The following examples show how to use the ECMP command. 

Command Compare Condition 

ECMP (ADDR, 0040) Any access to (hex) address 0040. 

ECMP (ADDR+IAQ, 0004) Instruction acquistion access to 0004. 

or 

ECMP ( I AQ, 0004) 

ECMP (ADDR-DBIN, 04EE) Write operation performed at 04EE. 

or 

ECMP(-DBIN,04EE) 

ECMP (OFF) None. Emulator comparison disabled. 

The emulator internal comparison can be selected as the triggering event for a breakpoint. This 
requires two instructions, one which defines the comparison as an "event" and one which selects 
the event as a breakpoint and specifies action after the breakpoint occurs. 

The emulator event (HEVT) command defines an event. To define the emulator comparison as 
an event, enter EEVT (INT). If EXT is used as a modifier, an event signal connected by the user 
is selected as the emulator event. 

The emulator breakpoint (EBRK) command selects the breakpoint condition and the action to 
be taken when the breakpoint condition occurs. 

The breakpoint condition may be the event (EVT) defined by the EEVT command, or it may be 
the emulator trace buffer full (HULL) condition, or whichever occurs first. Note that the trace 
buffer full condition occurs when the number of samples specified in the ETRC command have 
been taken. This number is between 1 and 256. The OFH keyword disables the breakpoint. 

The breakpoint action may be either SELF (stop emulator) or OFF (do not stop emulator). Break- 
point action OFF causes the AMPL software to interrupt the host computer. 
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The following examples show how to use the EBRK command: 
Command Breakpoint Condition 



EBRK (EVT, SELF) 
EBRK (FULL, OFF) 
EBRK (EVT+FULL, SELF) 
EBRK (OFF, OFF) 



Event 

Trace Completion 

Event or Trace 

None 



Breakpoint Action 

Stop Emulator 
Interrupt Host Computer 
Stop Emulator 
None 



Figure 3-1 is a flowchart example which shows the steps in setting up an emulator comparison 
breakpoint with the ECMP, EEVT, and EBRK commands. 
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Figure 3-1. Setting Emulator Comparison Breakpoint with ECMP, EEVT, EBRK 
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The emulator trace command allows selection of data samples to be stored in emulator trace 
memory. The form of the command is similar to the ECMP command. 

The first operand field of ETRC allows recording of all addresses accessed by the microprocessor 
(ADDR), only instruction acquisitions (ADDR+IAQ) or no trace (OFF). The second operand is a 
count of the number of samples desired. The count is Umited by the 256-word capacity of the 
emulator trace memory. The third operand allows selection of internal clock from the butter 
board or external clock. 

The following examples show how to use the ETRC command: 

Command Trace Condition 

ETRC (ADDR, 256, INT) Trace 256 memory bus addresses using 

internal (target system) clock enable. 

ETRC (ADDR+IAQ, 1 0, EXT) Trace 1 instruction addresses using 

external (trace module) clock enable. 

ETRC (lAQ, 50, INT) Trace 50 instruction addresses using in- 

ternal (target system) clock enable. 

ETRC (OFF) Disable trace logic. 

Figure 3-2 is a flowchart which shows how to set up the ETRC command and use the emulator 
trace memory full as the breakpoint condition. 

Note that the emulator trace memory stores memory addresses as they appear on the micro- 
processor address bus. It does not store the data written to or read from these addresses. The 
trace module, when interconnected with the emulator by control and data cables, can store the 
data read from or written to these addresses. 

Addresses stored in trace memory are accessed as if they were elements in a single dimension 
array (ETB) using an index in parentheses. Index zero corresponds to the most recently stored 
address. Previously stored addresses are accessed using negative index values, for example 
ETB(-9) An index of -1 corresponds to the address of the instruction preceding the one at the 
most recently stored address. More negative index values correspond to previously stored 
rdresses, and the oldest address is accessible at the most negative index value. System variable 
ETBO contains the index of the oldest address stored, and ETBN contains the index ol the 
newest address stored in the emulator trace memory. 

The status of the emulator can be determined by entering EST. The resulting output is a 
hexadecimal display. The least significant digit gives the status as tabulated in Section V ot this 
manual. There is a Ubrary procedure, ESTAT, which gives a plain text status pnntout. 

The emulator trace, if any, and microprocessor operation are initiated and halted by the ERUN 
and EHLT commands, respectively. 
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Figure 3-2. Setting Emulator Trace Breakpoint 



3.1.2 TRACE MODULE COMMANDS .AND VARIABLES. The trace module is also capable of 
tracing a maximum of 256 items, each consisting of up to 20 bits. The module stores the traced 
items in a 256 X 20 trace memory. The trace module can generate a signal when a specified 
number of items have been traced. The trace module also compares specified bits of each item to 
specified values, and generates an event signal when an equal comparison occurs. An event 
counter counts these signals, and starts counting delays when a specified number of events has 
occurred. Each item stored in trace memory after the events have been counted constitutes a 
delay; when the specified number of delays has occurred, the logic generates an event and delay 
completion signal. The breakpoint can stop the trace, signal the emulator to stop the micro- 
processor, or interrupt the host computer without stopping either the trace or the microprocessor. 
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The commands and system variables for the trace module closely parallel those which control the 
emulator. The TINT command must be entered first to initialize the trace module. The following 
is an example of a TINT command using the device name in the TX990 system supphed with 
the prototyping laboratory: 



TINT ('TRA') 



Initialize trace module TRA. 



For a DXIO system, the proper command is as follows: 



TINT(TMOr) 



InitiaUze trace module TMOl. 



Figure 3-3 is a flowchart of the steps in setting up a trace operation in the trace module. 

The TTRC command in the flowchart specifies tracing all addresses that are instruction acquire 
addresses (lAQ true), generating a completion signal when the count of addresses has been 
traced. EXT specifies the external clock, which is target system clock from the emulator. The 
OFF operand could have been omitted because it applies in default when no operand has been 
entered previously. This operand controls latching the four high-order bits to store glitches, and 
should be OFF when the data cable is connected to the emulator. 

The following examples show how to use the TTRC command: 

Command Trace Condition 



TTRC(ADDR+IAQ, 14, EXT, OFF) 



Trace 14 memory bus addresses using external 
(target system) clock. Trace only instruction 
addresses (lAQ true), and trace with latches 
off. 



TTRC (QO+Ql , 256, INT, ON) 



Trace 256 items to which probe leads are 
connected, using internal clock. Trace an item 
only when signals to which probe leads QO 
and Ql are connected are true. Enable latches 
onD0-D3. 



TTRC(DATA-DBIN, 25, EXT, OFF) 



TTRC(OFF, 256, EXT, OFF) 



Trace 25 memory data words using external 
(target system) clock. Trace only data that 
was written, and trace with latches off. 

Trace 256 words from emulator using external 
(target system) clock. Trace all data (qualifiers 
masked off) and trace with latches off. 



The TBRK command specifies that the trace completion signal is to be used to generate a 
breakpoint, and to signal the emulator to halt at completion of the current instruction. 
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Figure 3-3. Setting Trace Breakpoint in Trace Module 
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The following examples show how to use the TBRK command: 

Breakpoint Condition 

Trace Completion 



Command 

TBRK(FULL, SELF) 



Breakpoint Action 



TBRK(EVT, EMU) 
TBRK(EVT+FULL, SELF+EMU) 

TBRK(FULL, OFF) 



Event and Delay 
Completion. 

Event and Delay 
Completion or 
Trace Completion. 

Trace Completion 



Stop tracing, interrupt host compu- 
ter. 

Request emulator to halt. 



Stop tracing and request emulator to 
halt. 



Interrupt host computer. 



Items are stored in trace memory in a manner similar to the manner in which addresses are stored in 
the emulator trace memory. Items are accessed as if they are elements in a single dimension array 
(TTB) using an index in parentheses. Two system variables, TTBO and TTBN, contain the index 
values for the oldest and newest items traced, respectively. 

Trace module status can be displayed by entering TST. The status value returned is a 4-digit 
hexadecimal number. The TSTAT library procedure prints the status in plain text. 

In order to save memory space in the host computer, the library procedures are not automatically 
available when the AM PL system is called up. A COPY command with the file name of the library 
procedure may be used to bring the procedure into memory. It remains available until the symbol table 
is cleared by a CLR command. Each Hbrary procedure is accompanied by a short tutorial which 
describes the use of the procedure and the values, if any, required in the procedure call. To print the 
information, the user must enter a LIST command (paragraph 5.5.2) prior to entering the COPY 
command. Figure 3-4 is a sample of a copy statement and the resulting printout. The printout may be 
suppressed by a LIST (OFF) command. In the figure, the TDATA procedure has been copied. 

This short section on emulator and trace module commands is intended to provide sufficient 
background to follow some actual examples of AMPL system use in the development environ- 
ment. Detailed descriptions of the AMPL commands are contained in Section V. 

3.2 PROTOTYPING LABORATORY INITIAL CHECKS 

When the buffer module is connected to a target system, it is possible for the target system to 
interfere with proper operation of the AMPL system. The following initial checks identify these 
types of troubles so that they may be corrected before proceeding with further testing of the 
target system: 

• Buffer module checkout 

• Target system address and data bus checkout 

• Target system clock checkout 

• Target system memory checkout. 
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? LIST Clog') 

? COPY ( s TDUMP S /PRC ' ) 



TITLE! 
revision: 



TDATA: PRINT TRACE MODULE SAMPLES 
03/24/77 



ABSTRACT: 

TDATA PRINTS A SPECIFIED RANGE OF SAMPLES FROM THE TRACE MODULE 
TRACE BUFFER. THE SAMPLES ARE NOT INTERPRETED; ALL TWENTY BITS ARE 
PRINTED FOR EACH SAMPLE. 

USAGE: 

TDATA HAS ONE REQUIRED AND ONE OPTIONAL ARGUMENT. THE FIRST 
ARGUMENT IS THE STARTING INDEX TO BE USED. THE OPTIONAL SECOND 
ARGUMENT IS THE ENDING INDEX. IF IT IS OMITTED, THE ENDING INDEX 
IS THE STARTING INDEX PLUS 29, GIVING 30 SAMPLES, IF THERE ARE 
THAT MANY IN THE TRACE BUFFER. TDATA MAY BE CALLED WHENEVER THE 
TRACE MODULE IS HALTED. 

DEFINING TDATA NL 



...ENDING INDEX WAS GIVEN 
. . .NOT GIVEN 

...LIMIT ENDING INDEX 
. . .SET NEWLINE FLAG 
HIGH LOW'; 



■:.■ 


PROC 


TDATA<1,2) BEGIN 


1? 


IF 


ARG EQ 2 


1 "^ 




THEN LOC 1 = ARG 2 


1 '"' 




ELSE LOC 1 = ARG 1+29; 


1 '^ 


IF 


LOC 1 GT TTBN 


1 ''' 




THEN LOC 1 = TTBN! 


t '"' 


LO 


:; 2 = o; 


1 "' 




INDEX HIGH LOW 


f^' 




HIGH LOW ; 


1? 


WHILE ARG 1 LE LOC 1 


1 ? 




DO BEGIN 


;•■••' 




IF LOC 2 MOD 3 EQ 


■?•' 




THEN BEGIN 


;--:-7 




ARG l:ND 


-r'' 




END 


7? 




ELSE 


2""-' 




LOC 2 = LOC 2+1! 


?P 




TTBHCARG 1):H; 


7-? 




TTB(ARG 1):HA; 


2? 




ARG 1 = ARG 1+1! 


2? 




END; 



. .START A NEW LINE 

..TAB TO NEXT COLUMN 
, . . STEP THE FLAG COUNTER 
, . .DISPLAY SAMPLE 



!-• END 



(A)1 36533 



Figure 3-4. Sample Library Procedure 
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3.2.1 BUFFER MODULE CHECKOUT. The buffer module checkout procedure should be 
executed before connecting the AMPL system to a target system to verify that the buffer 
module is operating satisfactorily. The procedure may also be executed at any time there is a 
doubt of the proper operation of the buffer module. Perform the following steps: 

1 . Install the emulator and buffer modules and connect the cables as described in Section II. 
If the trace module is to be used in testing the target system, connect the trace module as 
required. Do not connect the target connector to the target system 

2. Set the CLOCK switch on the buffer module to the INTERNAL position. 

3. Apply power to the AMPL system. 

4. Load the AMPL program as described in paragraph 5.2. 

NOTE 

The emulator Halt Acknowledge indicator (figure 2-16) should be 
on at this point. If not, perform maintenance on the emulator 
module before continuing the test. 

5. Enter the EINT command to select the emulator. The following is an example of an EINT 
command. Substitute the device name of the emulator if EMU or EMDl is not the device 
name. 

? EINT ('EMU') Select emulator EMU (TX990). 

?EINT ('EMOl') Select emulator EMO! (DXIO). 

6. Enter the following statement to map emulator user memory into the address space: 

7. Enter the following command to make library procedure ESTAT available: 

? COPY ('.S#SYSLIB.AMPL$LIB.STAT') For DXIO. 

8. Call library procedure ESTAT. The following is an example of the call and the 
resulting display: 

? ESTAT: 
EMULATOR IS NOT EXECUTING. 
EMULATOR TRACE BUFFER IS NOT FULL. 
EVENT CONDITIONS ARE NOT SATISFIED. 

35 BREAKPOINTS COUNTED. 

1(1) ADDRESSES TRACED: -9 . . . (D 

9. The emulator should not be executing at this point. If the emulator is executing 
perform maintenance on the emulator before proceeding. 
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10. Enter the following function definition to test target memory: 

? FUNC MEMTST(3,1) BEGIN 

1? LOC 1 = AR6 1 

1? WHILE LOC 1 LOE ARG 2 DO 

1? BEGIN 

2? @LOC 1 = ARG 3 

2? LOC 1 = LOC 1 + 2 

2? END 

1? LOC 1 = ARG 1 

1? WHILE LOC 1 LOE ARG 2 DO 

1? BEGIN 

2? IF @LOC 1 NE ARG 3 THEN RETURN LOC 1 

2? LOC 1 = LOC 1 + 2 

2? END 

1? RETURN -1 

1? END 

11. Enter the following function call to execute function MEMTST. The example shows 
the return that is displayed by a successful test. If a hexadecimal address is displayed 
instead of the -1, the test has failed, and maintenance should be performed on the 
emulator before continuing. 

? MEMTST((3,>1FFE, >10FF) 
-1 

12. Enter the following statement to set the program counter of the target system: 

? PC = 01(110 

13. Enter the following command to start the emulator: 

? ERUN; 

14. Call procedure EST AT again. The following is an example of the call and the resulting 
display: 

? ESTAT; 
EMULATOR IS EXECUTING. 
EMULATOR TRACE BUFFER IS NOT FULL. 
EVENT CONDITIONS ARE NOT SATISFIED. 
>9Hft BREAKPOINTS COUNTED. 



15. If the emulator is not running, perform maintenance on the emulator before pro- 
ceeding. Otherwise, enter the following command: 

? EHLT; 
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16. Call procedure EST AT again. The following is an example of the call and the resulting 
display: 

? ESTAT" 
EMULATOR IS NOT EXECUTING. 
EMULATOR TRACE BUFFER IS NOT FULL. 
EVENT CONDITIONS ARE NOT SATISFIED. 
>0000 BREAKPOINTS COUNTED. 
ADDRESSES TRACED. 

If the display shows that the emulator is still executing, or if there have been error messages 
other than those caused by entering a command or statement incorrectly, there is a problem 
with the emulator or buffer module which must be corrected before performing any further 
tests. 

The following error message is typical of the error messages that indicate a buffer module problem: 

*** ERROR 205 0700 0001 

EMULATOR DSR ERROR; 

02XX = ILLEGAL OPERATION, 
05XX = MEMORY WRITE ERROR, 
06XX = OPERATION TIMED OUT, 
07XX = DEVICE ERROR. 

For a more thorough test of the emulator and buffer, perform the procedure in paragraph 5.3 to 
execute the hardware demonstration test. The hardware demonstration test also tests the trace module 
as an option. 

3 2 -> TARGET SYSTEM ADDRESS AND DATA BUS CHECKOUT. When the target connector 
is pfugged into a target system, faults on the address bus or data bus can cause improper bufter 
module operation. To detect this type of fault, perform the following steps: 

1 Verify that power to the target system is off, and plug the target connector into the 
' target system. If the value of EUM has been altered, repeat step 6 of paragraph 3.2.1. 

2. Apply power to the target system. 

3 Enter the following function call to execute function MEMTST (if the buffer module 
checkout has not been performed since the AMPL program was loaded, perform 
steps 5 and 10 of paragraph 3.2.1 before performing this step): 

? MEMTST(jl,>lFFE,>l$FF) 
-1 

4 If the return from function MEMTST is not ^1 as in the example, check the address 
bus and the data bus on the target system before proceeding. Otherwise, enter the 
following statement to set the program counter of the target system: 

? PC = tlU 
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5. Enter the following command to start the emulator: 

? ERUN; 

6. Call procedure ESTAT again. The following is an example of the call and the resulting 
display: 

? ESTAT; 
EMULATOR IS EXECUTING. 
EMULATOR TRACE BUFFER IS NOT FULL. 
EVENT CONDITIONS ARE NOT SATISFIED. 
>0000 BREAKPOINTS COUNTED. 

7. If the emulator is not running, perform checks on the target system before proceeding. 
Otherwise, enter the following command: 

? EHLT 

8. Call procedure ESTAT again. The following is an example of the call and the resulting 
display: 

? ESTAT; 
EMULATOR IS NOT EXECUTING. 
EMULATOR TRACE BUFFER IS NOT FULL. 
EVENT CONDITIONS ARE NOT SATISFIED. 
>«I0J« BREAKPOINTS COUNTED. 
ADDRESSES TRACED 

If the display shows that the emulator is still executing, or if there have been error messages 
other than those caused by entering a command or statement incorrectly, there is a problem 
with the target system; a cross, short, ground, or other improper connection on the target system 
prevents proper operation of the emulator or proper memory access. Correct the problem before 
attempting any further tests. Error messages shown in paragraph 3.2.1 are typical. 

3.2.3 TARGET SYSTEM CLOCK CHECKOUT. After verifying that the emulator works 
properly when connected to the target system, perform the following steps: 

1 . Set the CLOCK switch on the buffer module to the TARGET SYS position. 

2. Enter the EINT command as in step 5 of paragraph 3.2. 1 to select the emulator. An EINT 
command must be issued following each change of CLOCK switch settmg. 

3. Enter the following function call to execute function MEMTST. The example shows 
the return that is displayed by a successful test. If a hexadecimal address is displayed 
instead of the -1, the test has failed, and the target system clock circuitry should be 
checked before continuing. 

? MEMTST(0,>1FFE,>1$FF) 
-1 

4. Enter the following statement to set the program counter of the target system: 

? PC = (D10U 
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Enter the following command to start the emulator: 

? ERUN; 

Call procedure ESTAT. The following is an example of the call and the resulting 
display: 

? ESTAT; 
EMULATOR IS EXECUTING. 
EMULATOR TRACE BUFFER IS NOT FULL. 
EVENT CONDITIONS ARE NOT SATISFIED. 
BREAKPOINTS COUNTED. 



7. If the emulator is not running, check the target system clock circuitry before con- 
tinuing. Otherwise, enter the following command: 

? EHLT; 

8. Call procedure ESTAT again. The following is an example of the call and the resulting 
display: 

? ESTAT; 
EMULATOR IS NOT EXECUTING. 
EMULATOR TRACE BUFFER IS NOT FULL. 
EVENT CONDITIONS ARE NOT SATISFIED. 
>000(J BREAKPOINTS COUNTED. 
ADDRESSES TRACED 

If the display shows that the emulator is still executing, or if there have been error messages 
other than those caused by entering a command or statement incorrectly, there is a problem 
with the target system clock. Correct the problem before attempting any further tests. Error 
messages shown in paragraph 3.2.1 are typical. 

3.2.4 TARGET SYSTEM MEMORY CHECKOUT. After verifyir- that the emulator works 
properly when connected to the target system and clocked by the target system clock, verify 
target system memory by performing the following steps: 

1. Enter the following statement to map target system memorv into addresses through 
IFFF.e : 

? EMU = 8) 

2. Enter a function call to execute function MEMTST. The arguments of the example shown 
assume that addresses through IFFFi^ are available as Random Access Memory (RAM) 
in the target system. The first argument should be the lowest address available and the 
second argument should be the highest address available within the range of to FFFF,6 . 
The example shows the return that is displayed by a successful test. If a hexadecimal 
address is displayed instead of the -1, the test has failed, and target system memory 
should be checked before continuing. 

? MEMTST(0,>1FFE,>1(Z)FF) 
-1 

3. Enter the following statement to set the program counter of the target system. The 
value shown is consistent with the arguments of the call to MEMTST in the preceding 
example. Use a value within the range of the first two arguments of the call to 
MEMTST. 

? PC = 
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4. Enter the following command to start the emulator; 

? ERUN; 

5. Call procedure EST AT. The following is an example of the call and the resulting 
display: 

? ESTAT; 
EMULATOR IS EXECUTING. 
EMULATOR TRACE BUFFER IS NOT FULL. 
, EVENT CONDITIONS ARE NOT SATISFIED. 
>HH BREAKPOINTS COUNTED. 

6. If the emulator is not running, check the target system memory before proceeding. 
Otherwise, enter the following command: 

? EHLT; 

7. Call procedure EST AT again. The following is an example of the call and the resulting 
display : 

? ESTAT" 
EMULATOR IS NOT EXECUTING. 
EMULATOR TRACE BUFFER IS NOT FULL. 
EVENT CONDITIONS ARE NOT SATISFIED. 

$ BREAKPOINTS COUNTED. 

ADDRESSES TRACED 

If the display shows that the emulator is still executing, or if there have been error messages 
other than those caused by entering a command or statement incorrectly, there is a problem 
with target system memory. Correct the problem before attempting any further tests of the 
target system. Error messages shown in paragraph 3.2.1 are typical. 

When the preceding tests of the target system have been performed successfully, the interface 
between the target system and the buffer module is working properly. Proceed with further tests 
of the target system. 

3.3 PROTOTYPING LABORATORY APPLICATION EXAMPLE 

A real-life example of prototyping laboratory application to development problems may help bring 
together many of the AM PL concepts in this book. This particular application uses only a very small 
part of the AMPL capability to rapidly solve a problem which resists analysis by conventional 
diagnostic program, oscilloscope, and logic analyzer techniques. 

The target system is a peripheral controller under development for use with the 990 family of 
computers. The controller uses a TMS 9900 microprocessor and a 2K ROM program to control 
data transfer to and from a bulk storage device. An onboard RAM provides a scratch pad for the 
TMS 9900 and a data buffer between the 990 computer and the storage device. This data buffer 
is managed as a "software FIFO" (first in, first out) buffer by the TMS 9900 microprocessor. 
The peripheral controller is installed in a 990 computer, and is exercised by a diagnostic program 
running in the 990 computer. 

An intermittent failure in data transfer and device control occurs as the diagnostic tests are 
performed. This intermittent failure occurs once in 30 or 40 minutes of continuous operation. 
The diagnostic test printouts indicate a data buffer underflow, which does not pinpoint the 
problem, even with a conventional logic analyzer. 
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The solution to the problem is complicated by the real-time operating environment required by 
the peripheral device. It is not possible to insert breakpoints into the controller program and still 
maintain control of the peripheral device. For the same reason, it is not possible to single-step 
through the controller program. 

The random nature ot the failure indicates the possibility of a noise problem. An oscilloscope is used to 
trace noise sources and noise sources are suppressed. 1 he result of this effort is a noise-free board with 
an intermittent failure. The problem is solved by the AM PL prototyping laboratory as described in the 
following paragraphs. 

The trace and emulator modules are connected together in the emulator control and data mode (figure 
5- 1 ), and the target connector is plugged into the TMS 9900 socket on the peripheral comroUer under 
test. 

The TDATA, TEDUMP, TSTAT, and ESTAT procedures are copied from the AMPL system 
diskette, using the procedures of Appendix H. The "canned" procedures and functions of Appendix H 
add significantly to ease of operation. 

The fault is accompanied by an indication of data buffer undertlow, so it seems reasonable to 
install a breakpoint when underflow occurs, and then to examine the events leading up to the 
undertlow. 

Memory location 10D2,6 in the peripheral controller is used as a counter which keeps track of 
the number of words in the "software FIFO". During a write operation to the bulk storage 
device, this counter should increment as data is loaded into the FIFO, and decrement as data is 
transferred out. Under normal control by the read/write program, the counter contents should 
never go negative. 

The emulator is set up to monitor and to give a compare each time an access is pertormed to 
FIFO counter address 10D2,6. such as: 

? ECMP (ADDR,>10D2) 
The trace module is set up to trace data written into that address as follows: 
? TTRC (DATA+EMU-DBIN, 256, EXT) 

This command traces data when the emulator compare is true (+FMU) and a write operation 
(-DBIN) is performed. The emulator compare was previously set to occur at address IOD^k,- 

The TTRC command is verified by entering: 

?TTRC; 

The response is: 

+DATA-DBIN+EMU 

256 
+EXT 
+0FF 
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This verifies that the TTRC command was accepted and displays the current values of the 
optional arguments which were not modified by the TTRC command. In the preceding case, 
these are the default values. 

The select trace event command TEVT is checked by entering: 

?TEVT; 
The response is: 
1 
+NORM+EACH+INT 

These are the default parameters and are correct as is. They specify that 1 event will stop the 
trace, that there will be no delay, triggering will be on the true level, each equal comparison will 
he counted, and the internal trace module comparison will be used as the event. 

The trace module will be set to give a compare when all the trace conditions are met, and the 
FIFO counter goes negative. This command is entered as follows: 

?TCMP {DATA+EMU-DBIN,(/)FFFF,0FFFF) 

The first 3 conditions are the same as used in the TTRC command; that is, when the emulator 
compares (at address 10D2i6), and a write operation is performed. The second entry is the value 
FFFF,6. The mask (third entry, OFFFF) examines the least significant 16 bits of the 20-bit 
trace word. If address 10D2i6 contains FFFFie, the FIFO counter has underflowed (gone 
negative). 

The breakpoints are set up with the EBRK and TBRK commands as follows: 

?EBRK (OFF, SELF) 
?TBRK (EVT.SELF) 

and the emulator and trace modules are started with: 

?TRUN; 
?ERUN; 

Wait for a failure of the peripheral controller. Status of the trace can be checked periodically in 
the TST variable with the TSTAT procedure. The TSTAT procedure gives a plain language status 
printout, rather than a hexadecimal code, as shown below: 

7TSTAT; 

TRACE MODULE IS NOT TRACING 
TRACE BUFFER IS FULL 
EVENT CONDITIONS ARE SATISFIED 
0IDO1 BREAKPOINTS COUNTED 
256 SAMPLES IN BUFFER: -255 ... 
EVENTS COUNTED 
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rilis status printout indicates that tiic e\ent occurred. A trace dump procedure (TDA I A) can be used 
to print all 256 data \alues in the trace butler, as shown in ligure 3-5. The INDEX column shows the 
index into the trace bulTer. with the oldest sample printed first. I hree samples are printed in each row. 
1 he values ol interest are the hexadecimal values printed in the l-OW columns. Each ot these \alues 
represents a 16-bit EIEO counter \alue written into location I()D2|„. 

The EIEO counter is at 13i6 when sample -255 is taken. The counter mcrements toa ma.ximum value ot 
50i6 (sample -194) as the EIEO lilts, and decrements to (sample -1 14) as the EIEO empties. The 
pattern is shown in figure 3-6. An unexplained reset, trom 31h, to occurs at sample -1, and the 
undertlow occurs on the next access. 

This test with the prototyping laboratory shows that the underflow of the EIEO counter is. in 
this case, apparently caused by a "phantom reset" of the EIEO counter in the middle of a data 
transfer. 

Now investigation centers on the possible causes of this "phantom reset". Somehow, some 
instruction is writing a zero value into address 10D2,e. It might be a CLR instruction, a MOV, 
or a number of other instructions. 

Reading the program listing shows several instructions capable of clearing address 10D2,f,- These 
instructions are part of the normal program, but it may be that a code containing a clear 
instruction is being executed out of sequence. 

Set up the emulator module to trace addresses and the trace module to trace data as follows: 

?ETRC {ADDR,256,EXT) 
?TTRC (DATA, 256, EXT) 

Define the emulator event as the internal compare, and the emulator breakpoint as the emulator 
event, as follows: 

?EEVT (INT) 
?EBRK (EVT.SELF) 

Set up the emulator compare to occur when the suspected instruction is executed. This is done 
with an ECMP command: 

?ECMP (IAQ,>hex address of suspected instruction) 

Start the trace with the TRUN and ERUN commands, and wait for the failure to occur. If the 
failure occurs, but the emulator compare does not, the suspect instruction did not cause the 
failure. If the emulator compare does occur and the failure does not, the instruction has 
executed without causing the failure. The trace is repeated until the failure occurs, and if no 
compare accompanies the failure, a new instruction is selected for examination. 

If the failure is accompanied by a compare, the trace and emulator buffers are dumped via a 
TEDUMP procedure. The TEDUMP procedure prints out the emulator trace indexes, the address, 
the corresponding trace buffer index and the instruction, as shown in figure 3-7. 
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Figure 3-5. TDATA Printout for Prototyping Lab Example (Sheet 1 of 2) 
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:>oooi 


>0041 


.A 


.50001 


50042 


.B 


>0001 


50043 


.c 




-45 


/ 


>0001 


>0044 


.D 


>0001 


:>0045 


.E 


>0001 


>0046 


.F 




-42 


/ 


>0001 


>0047 


.0 


50001 


>0048 


.H 


>0001 


>0049 


. I 




-39 


/ 


>0001 


>004A 


.J 


50001 


5004B 


.K 


>0001 


>004C 


.L 




-36 


/ 


>0001 


>004D 


.M 


>0001 


>004E 


.N 


>0001 


>004F 


.0 




-33 


/ 


>0001 


>0050 


.P 1 


>0001 


5004F 


.0 — 1 


50001 


>004E 


.N 




-30 


/ 


>0001 


>004D 


.M 


50001 


5004C 


.L 


>0001 


>004B 


.K 




-27 


/ 


>0001 


>004A 


.J 


50001 


50049 


. I 


50001 


>0048 


.H 


BUFFER 
* STARTS 


-24 


/ 


>0001 


>0047 


.G 


>0001 


>0046 


.F 


>0001 


>0045 


.E 


EMPTYING 


-21 


/ 


>0OOl 


>0044 


.D 


>0001 


>0043 


.C 


>0001 


>0042 


.B 




-18 


/ 


>0001 


>0041 


.A 


50001 


>0040 


.e 


>0001 


>003F 


. 7 




-15 


/ 


>0001 


>003E 


.;> 


>0001 


5003D 


.= 


>0001 


>003C 


.< 




-12 


/ 


>0001 


:>003B 


. ; 


50001 


>003A 


. i 


>0001 


>0039 


.9 




-9 


/ 


>0001 


:>0038 


.8 


50001 


>0037 


.7 


>0001 


>0036 


.6 




-6 


/ 


>0001 


50035 


.5 


50001 


50034 


.4 


>O0Ol 


■^0033 


.3 




-3 


/ 


>0001 


>0032 


.2 


50001 


50031 


. 1 


50001 


50OO0 









/ 


>0001 


;>FFFF 


■ ■ 


^ BUFFER 


\ 




. 


/ 






? 




DISC 


"TV 

ONTINUITY 




















X/buffer starts 












UNDERFLOW 


FULL 






EMPTYING 
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Figure 3-5. TDATA Printout for Prototyping Lab Example (Sheet 2 of 2) 



The 256 sample trace has been shortened in the figure. The emulator compare occurs at emulator index 
-3. Prior history is checked by reading up the printout from index toward -256. At -38, a level 7 
interrupt (address OOIC16) is reported. However, the peripheral controller is not supposed to have an 
interrupt on level 7. The lowest priority interrupt should be a 4 millisecond timer at level 4. The 
interrupt priority assignments are at fault in this case. The valid level 4 interrupt is not being serviced in 
time. It is causing an interrupt request, but by the time the priority encoder is tested, the valid interrupt 
has disappeared, leaving a default hexadecimal 7 on the priority encoder output. The code associated 
with level 7 interrupts is causing a FIFO underflow indication, and masking the real problem, 
occasional failure to service the timing interrupt. 

A reassignment of interrupt priorities assures that the timing interrupt could not be masked lor an 
excessive length of time, and completely cures the problem. 
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? TSTAT 
TRACE MODULE IS TRACING. 
TRACE BUFFER IS FULL. 
EVENT CONDITIONS ARE SATISFIED. 
>0000 BREAKPOINTS COUNTED. 
? ESTAT 
EMULATOR IS NOT EXECUTING. 
EMULATOR TRACE BUFFER IS FULL. 
EVENT CONDITIONS ARE SATISFIED. 
>0001 BREAKPOINTS COUNTED. 
256 ADDRESSES TRACED! -255 

? TEDUMP(ETBO,ETBN) 



1U INDEX 


EC 


MP" 


RDIiR 


TRR IMDEX 


dhtr ■ he: 


-255 






>102A 


-55 


> 055S . 


-254 






>OCOE 


-54 


>iFi:i'5 . 


-253 






>1038 


-53 


> u Oh u 


-252 






>0C10 


-52 


•160E . 


-251 






>0C12 


-51 


>31Ci5 1 


-250 






>102A 


-50 


>n555 , 



1 H iU 



INTERRUPT 
OCCURS 



-44 
-43 
-42 
-41 
-40 
-39 
*■ -38 
-37 
-36 
-35 
-34 
-33 
-32 
-31 
-30 
-29 
-28 
-27 
-26 
-25 
-24 
-23 
-22 
-21 
-20 
-19 
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>1036 


156 


>0BB2 


157 


>0BB2 


158 


>103E 


159 


>103C 


160 


>103A 


161 


>001C 


162 


>10BE 


163 


>10BC 


164 


>10BA 


165 


>001E 


166 


>01CA 


167 


>01CC 


168 


>10AA 


169 


>01CE 


170 


>01D0 


171 


>015C 


172 


>015C 


173 


>10AA 


174 


>10AA 


175 


>015E 


176 


>10AA 


177 


50160 


178 


>10E2 


179 


>10E2 


180 


>0162 


181 



UBE£ 


, c! 


OSSfi 


, , 


CiSSO 


, , 


C4u6 


U ■ 


0366 


.F 


1 


, . 


1 Oh 




C406 


n. 


366 


.F 


1 


. . 


01 Ch 


. _! 


0£05 


, , 


047 


■ '^ 


047 


■ Ij? 


046 




01511: 




06C5 


.E 


06C5 


.E 


047 


. G 


4 7 


f T ■ 


riS05 


X . 


47 


b . 


10E3 


. c 


OS 


, . 


034 7 


. G 


53£0 





IHTERPREThTIDN 
WRITE >0555 

TB >0005 

READ >00A0 

JNE ♦+>0013 

LDCR R5,4 

READ >0555 



READ 


>0BB2 


READ 


>0380 


READ 


>C406 


READ 


>0366 


READ 


>1000 


READ 


>10A0 


WRITE 


>C406 


WRITE 


:>0366 


WRITE 


>1000 


READ 


>01CA 


LI R5,>0000 


READ 


>0047 


WRITE 


>0047 


B e>oooo 


READ 


>015C 


READ 


>06C5 


SWPB R5 




READ 


:>0047 


WRITE 


>4700 


MOVB R5,e>0000 


READ 


:>4700 


READ 


>10E3 


READ 


>0800 


WRITE 


>0847 


szcB e>oooo,e>oooo 



Figure 3-7. TEDUMP Printout for AMPL Example (Sheet 1 of 2) 
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-18 

-17 

-16 

-15 

-14 

-13 

-12 

-11 

-10 

-9 

-8 

-7 

-6 

-5 

-4 

-3 

-2 

-1 

O 



*ECMP 



>0164 


182 


>0028 


183 


>0166 


184 


>10E2 


185 


>10E2 


186 


>0168 


187 


>016A 


188 


>002E 


189 


>016C 


190 


>10E2 


191 


>10E2 


192 


>016E 


193 


>0170 


194 


>10E0 


195 


>10E0 


196 


>0172 


197 


>0174 


198 


>10D2 


199 


>10D2 


200 



i:m:i£9 


• .-• 




READ >0029 


. ) 


5 i:id£ 


p.. 




READ :>5022 


P" 


1 0E£ 


.B 




READ >10E2 


.B 


0347 


. G 




READ >0847 


.G 


i:i847 


. G 




WRITE >0847 


.G 


F£:£0 


. 


socB e>oooo,e>oooo 


Oi:i£E 






READ >002E 


• ■ 


no 


P. 




READ >D000 


P. 


1 0E£ 


.E 




READ >10E2 


.B 


0847 


. G 




READ >0847 


.G 


riS47 


KG 




WRITE >D847 


XG 


04E 




CLR 


«>oooo 




lOEO 


..? 




READ >10E0 


.e 


7 


P. 




READ >7000 


p. 









WRITE >0000 


m m 


04E 

1 ori£ 


.R 


CLR 


e>oooo 

READ >10D2 


.R 


03 1 
00 


. 1 




READ >0031 
WRITE >0000 


. 1 

• ■ 
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Figure 3-7. TEDUMP Printout for AMPL Example (Sheet 2 of 2) 

3.4 TRACE PROBE EXAMPLE 

The trace module may be used independently of the emulator for general tracing operations. For 
example, a tape cassette controller is experiencing data readback failures during diagnostic-testing. 
The diagnostic shows that a hexadecimal "05" is being read back occasionally from a record of all 
"04" characters. The problem appears to be in the data, rather than in the operation of the periph- 
eral controller program. 

Figure 3-8 is a simplified diagram of the controller "front end". If the error is present at the FIFO 
output, the error must be ahead of (or in) the FIFO. This would eliminate the program and all the 
logic downstream from the FIFO. 

To determine if the error is present at the FIFO output, attach a DIP test adapter onto the 3341 
FIFO device and attach the trace probe leads to the adapter pins corresponding to FIFO I, 2, 3, 
and 4. Any 4 of the 20 trace data leads could be used but they should represent one hex character, 
with LSB to MSB order preserved. For this example, the four least significant leads, D16-D19, 
are used. The CLOCK lead is attached to the shift out clock pin. The GND lead is connected to 
logic ground. 

The other end of the trace probe cable is connected to the trace module, replacing the emulator/ 
trace data cable. 

The emulator will only be used to supply a TMS9900 microprocessor to the target system. 
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Set up the trace as follows: 

?TTRC ((JFF,126,+EXT,+(ZIFF) 

The quahfiers, Q0-Q3, are not required, 126 samples are to be stored, and the rising edge of the 
external (FIFO shift out) clock is used. The latch mode is disabled. 

Set up a comparison to provide a breakpoint when the error occurs, as follows: 

? TCMP(0FF,5,(JF) 
Specify 1 test event, and delay of 128 as follows: 

?TEVT (1,128) 

^^ This puts the event in the middle of the 256-word trace buffer, so data on either side of the 

event may be examined. 

The trace breakpoint is defined as: 

?TBRK (EVT.EMU) 
and the trace is initiated by: 

?TRUN; 
?ERUN; 

After the target system read operation is started, the status is checked and the trace module trace buffer 
is printed out by TDATA. The printout, figure 3-9, shows that the faulty data is appearing at the FIFO 
output, so the fauU is ahead of this point. The program and about 90% of the logic have been 
exonerated by this quick test, which takes longer to describe than to perform. 



3.5 IMS 9980 EXAMPLES 

The application examples are for target systems that use the TMS 9900 microprocessor. They may be 
used on a target system that uses a TMS 9980 microprocessor, but the addresses and data stored in the 
memories of the emulator are different. To understand the difference, consider the difference in the 
microprocessors. 

The most significant difference between the microprocessors is that the TMS 9900 has a 16-bit data 
bus, and accesses a word of memory at each memory access, and the TMS 9980 has an 8-bit data bus 
and accesses a byte of memory at each memory access. The TMS 9980 performs two memory accesses 
for each word required. In the emulator (in which memory addresses are traced) a trace operation 
stores the addresses of each byte stored. When the trace module is tracing data supplied by the 
emulator, the data is supplied on a 16-bit bus. During a memory access of an even address, the most 
significant byte of the bus contains the data being transferred to or from memory, and the least 
significant byte contains random data. During a memory access of an odd address, the least significant 
byte of the bus contains the data being transferred to or from memory, and the most significant byte 
retains its previous contents. Thus the entire word as it is stored in memory is present on the 1 6-bit data 
bus during a memory access to an odd address. 
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TCMP(0FF,5,0F) 
? TRUN 



? ERUN 

? TSTAT 
TRACE MODULE IS NOT TRACING. 
TRACE BUFFER IS FULL. 
EVENT CONDITIONS ARE SATISFIED 
>0000 BREAKPOINTS COUNTED. 

256 SAMPLES IN BUFFER: -1 
:0001 EVENTS COUNTED. 

? TDATA<TTBO,TTBN) 
INDEX HIGH LOW 
-127 / >0000 >0004 



27 



-124 


/ 


>0000 


>0004 


-121 


/ 


>0000 


>0004 


-118 


/ 


>0000 


>0004 


-115 


/ 


::oooo 


>0004 


-112 


/ 


>0000 


>0004 


-109 


/ 


>0000 


>0004 


- 1 06 


/ 


>0000 


>000E 


-103 


/ 


>0000 


>000C 


- 1 00 


/ 


::oooo 


>0003 


-97 


/ 


>0000 


>000A 


-94 


/ 


>0000 


>0004 


-91 


/ 


>0000 


>0004 


;; 








-22 


/ 


>0000 


>0004 


-19 


/ 


>0000 


:.ooo4 


-16 


/ 


>0000 


>0004 


-13 


/ 


>0000 


>0004 


-10 


/ 


>0000 


>0004 


-7 


/ 


>0000 


>oooo 


-4 


/ 


>0000 


>000A 


-1 


/ 


>0000 


>0000 


jL 


/ 


>0000 


>000C 


5 


/ 


>0000 


::0008 


8 


/ 


>0000 


>0004 


11 


/ 


>0000 


>0004 


14 


/ 


>0000 


>0004 


17 


/ 


::oooo 


>0004 


20 


/ 


>0000 


>0004 


23 


/ 


::oooo 


::0004 


116 


/ 


>0000 


>0004 


119 


/ 


>0000 


>0004 


122 


/ 

I 


>0000 


>0004 


125 


/ 


>0000 


>0004 


128 


/ 


>0000 


>0004 



128 



HIGH 


LOW 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0O00 


>0000 , . 


>0000 


>OOOA . . 


>0000 


>0000 , . 


>0000 


>0000 . . 


>0000 


>000A . . 


>00O0 


>0OO4 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 


::0000 


>0004 . . 


>0000 


>0004 ■ . 


>0000 


>0004 . . 


>0000 


>000E . . 


>0000 


>000C . . 


:>Qooo 


>0005 , . 


>0000 


:>oooA . . 


>0000 


;: 0004 


>0000 


>0004 . . 


>0000 


>0004 . . 


:>oooo 


>0004 . . 


>0000 


>0004 


>0000 


>0004 . . 


>0000 


>0004 . . 


::oooo 


>0004 


>0000 


>0004 . . 


>0000 


>0004 . - 


>0000 


>0004 . . 



HIGH 


LOW 


>0000 


>0004 . . 


>0000 


>0004 . , 


>oooo 


>0004 . . 


>oooo 


>0004 , . 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0000 . . 


>0000 


>OOOA . . 


>0000 


>0000 . . 


>oooo 


>oooc . . 


>oooo 


>0008 . . 


>oooo 


>0004 . . 


>oooo 


>0004 . . 






>oooo 


>0004 . . 


>oooo 


>0004 . . 


>0O00 


>0004 . . 


>oooo 


>0004 . . 


>oooo 


>oooo . . 


>0O00 


>000A . . 


>0000 


>oooo . . 


>0000 


>0000 . . 


>oooo 


>OOOA . . 


>0000 


>0004 . . 


>oooo 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 


>0000 


>0004 . . 






;>oooo 


>0004 . . 


>0000 


>0004 , . 


>0000 


:>ooo4 . . 


>0000 


>0004 . . 
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Figure 3-9. Trace Probe Example 
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When the examples as stated for the TMS 9900 microprocessor are executed in the TMS 9980 
microprocessor, the emulator trace memory contains redundant addresses and the trace module 
memory contains meaningful information in alternate words. Quahfier QO of the trace module is 
connected to the least significant address bit, true on even memory addresses. By using qualifier 
DATA-QO in the TTRC commands, the trace module memory stores only alternate words, when the 
data stored consists of valid memory words. Thisdatacorresponds to the data traced in the TMS 9900 
operation. By specifying EXT in the ETRC command, the clock for tracing in the emulator is enabled 
by the trace module clock (qualified by QO), and odd addresses are traced. Thus the capabilities of the 
AM PL Microprocessor Prototyping Laboratory are as effective in developing TMS 9980 systems, but 
the commands are somewhat different. Details of the differences in the commands are described in 
Section V. 
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SECTION IV 
AMPL MICROPROCESSOR PROTOTYPING LANGUAGE 

4.1 INTRODUCTION 

Statements entered by the user to control the emulator, trace module, and target system are 
written in the AMPL Microprocessor Prototyping Language. AMPL elements are used as operands 
of the user commands described in Section V. 

Statements entered at the operator console are checked for syntax and translated into an 
intermediate code. The intermediate code is processed by the AMPL Interpreter, which performs 
the operation specified by the statement. 

4.2 LANGUAGE ELEMENTS 

The characters of the AMPL character set are combined to form the following language 
elements: 

• Constants 

• Symbols 

4.2.1 CHARACTER SET. The set of ASCII characters recognized by AMPL consists of the 26 
letters (A-Z), the ten numerals (0-9), and the following special characters: space, ", ', (, ), *, /, +, 

9 ••••<> I @ # 

NOTE 

AMPL accepts only upper case characters. If a 9 1 1 VDT is being used 
as the console, push the key labeled UPPER CASE LOCK. This key 
is in the upper left corner of the keyboard. 

These special characters are used as follows: 

space To separate keywords and symbols 

To enclose character constants 
To enclose character strings 
( ) To enclose argument lists and subexpressions 

*/+- To indicate arithmetic operations 

= To assign a value to a variable 

To identify load module symbols 
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To separate elements in argument lists 

To identify the following characters as a comment 

? To request user input, and to specify a display and modify operation 

: To concatenate a format specification to an expression to be displayed 

: : To separate the expression from the statement in a CASE statement 

; To terminate a display and modify operation, and (optionally) to separate 

statements within a procedure, function, or compound statement 

< To identify the following digits as a binary constant 

> To identify the following digits as a hexadecimal constant 

! To identify the following digits as an octal constant 

@ To indicate an indirect target memory access 

# To enclose single source code lines for assembly 

4.2.2 CONSTANTS. The user may specify a constant in any of the following formats: 

Decimal 

Hexadecimal 

Octal 

Binary 

Character 

Instruction 

The expressions required in AMPL statements may include one or more constants, alone or 
combined with other elements by means of arithmetic or logical operators. 

4.2.2.1 Decimal Integer Constants. A decimal integer constant is entered as a string of decimal 
digits (0 through 9), the first of which may not be 0. The range of values of decimal integers is 1 
through 32767. The following are valid decimal constants: 

Constant Value 

1000 1000or3E8,6 

23 23 or 17,6 

The following is an invalid decimal constant: 

0250 f'irst digit is zero. 
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Fl6 


or 15 


250, 6 or 592 







IOO16 or 256 


28,6 


or 40 


F3,6 


or 243 



4.2.2.2 Hexadecimal Integer Constants. A hexadecimal integer constant is entered as a string of 
hexadecimal digits (0 - 9, A - F). Either the first digit must be zero or tlie string must be 
preceded by a greater-than character (>). The range of values of hexadecimal integers is 
through FFFFi6- The following are vaHd hexadecimal constants: 

Constant Value 

OF 

0250 



MOO 

>28 

>F3 

4.2.2.3 Octal Integer Constants. An octal integer constant is entered as a string of octal digits 
(0 - 7) preceded by an exclamation point (!). The range of values of octal integers is zero through 
1777778. The following are vaUd octal constants: 

Constant Value 

!173 1738 or 7B, 6 or 123 

!2620 26208 or 590,6 or 1424 

!14 148 or C16 or 12 

4.2.2.4 Binary Integer Constants. A binary integer constant is entered as a string of binary digits 
(0 or 1) preceded by a less-than character (<). The range of values of binary integers is through 
11111111111111112- The following are valid binary constants: 

Constant Value 

<101101 IOIIOI2 or2D,6 or45 

<100 1002or4 

<010011010010 IOOIIOIOOIO2 or4D2,6 or 1234 
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4.2.2.5 Character Constants. A cliaracter constant is entered as a string of one or two characters 
enclosed in quotation marl<s. The characters are represented internally as eight-bit ASCII 
characters with the leading bit set to zero. When a cliaracter constant consists of one character, 
the character is right-justified and leading zeros are placed in the internal representation. The 
following are valid character constants: 

Constant Value 

"AB" 4142,6 

"C" 0043 16 

"#/" 232F,6 

4.2.2.6 Instruction Constants. An instruction constant is entered as a source code instruction 
hne enclosed in pound signs (#). The source code line consists only of an operation field and an 
operand field. No label field is entered, and comments are not entered within the pound signs. 
(Comments may be entered as in any AMPL statement as described in paragraph 4.2.6.) Only 
instruction operation codes and pseudo-instrucfion operation codes RT and NOP may be used. 
Workspace registers must be specified as RO through R15. and the operand field of jump 
instrucfions must be program-counter relative; i.e., $+4, $-2, etc. 

The operand field of an instruction constant may not contain a label or a user symbol. It may contain a 
load module symbol. A load module symbol (paragraph 4.2.3.3) is a symbol in a program that has been 
loaded into target system memory. 

An instruction constant may be used in an assign statement (paragraph 4.6.2) or in the display and 
modify mode (paragraph 4.6.3.5). In the first case, the internal form of an instruction constant is a 16- 
bit word containing the machine instruction (or the first word of the machine instruction) derived trom 
the source code instruction. Two- and three-word instructions require that the literal value or address 
or addresses be entered as integer constants or variables, even though the value or address has been 
specified in the source code. The AMPL single line assembler requires the operands to correctly 
assemble the addressing modes in the first instruction word, but does not assemble second and third 
words of instructions. 

When an instruction constant is used in the display and modify mode the complete instruction (one, 
two or three 16-bit words) is assembled and placed in target system memory. Examples of use of 
instruction constants in this mode are shown in paragraph 4.6.3.5. 

The following are examples of instruction constants used other than in the display and modify mode: 

#MOV *R0+,*R1# A move instruction that moves the word at the ad- 

dress in workspace register to the address in work- 
space register 1 , and increments workspace register 
by two. The value of the constant is C470i6. 



44 Digital Systems Division 



^ 



946244-9701 



#LI R0, >FFFF# A load immediate instruction that places a value in 

workspace register 0. The value of the instruction 
constant is 0200i g. The value to be placed in work- 
space register is the contents of the word that 
follows the instruction constant. 

#MOV @(D10(D,@(S3(D®(R1)# A move instruction that moves the word at location 

IOO16 to location SOOj ^ indexed by workspace 
register Rl. The value of the instruction constant is 
C86O1 6 . The actual addresses for the instruction are 
the contents of the two words that follow the ad- 
dress constant. 

#JMP $-4# A jump instruction. The value of the instruction 

constant is lOFD, g. 

The following are examples of invalid instruction constants: 

#JMP ')')l(/)4# Invalid. Jump instructions may not specify addresses. 

#LOOP MOV *R!j+,*Rl Invahd. The label field may not be used. 

#DEF BUFF,MSG1# Invahd. Assembler directives may not be used. 

4.2.3 SYMBOLS. The symbols used in AMPL may be of any of the following types: 

• User symbols 

• System symbols 

• Load module symbols 

The expressions required in AMPL statements may include one or more symbols, alone or 
combined with other elements by means of arithmetic or logical operators. 

4.2.3.1 User Symbols. A user symbol is a string of alphanumeric characters, the first of which 
must be alphabetic. If more than six characters are entered, the first six characters are stored 
internally as the symbol and the remaining characters are ignored. The software prints a warning 
message. The user defines a symbol to represent a location within a program, a mask, a counter, 
a constant, a variable, a switch, or a flag. The following are valid user symbols: 

LBLl 

STOPHERE Internal representation of this symbol 

consists of STOPHE (first six characters). 

The following are not valid user symbols for the reasons indicated: 

ILOC Begins with a numeral. 

A! BC Contains a special character. 

User symbols are global symbols; i.e., they continue to apply until the symbol table is cleared. 
User symbols must be unique with respect to each other and with respect to system symbols and 
reserved words (Appendixes D and E). 
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4.2.3.2 System Symbols. A system symbol is a string of up to tour alphanumeric characters that 
is predelined in AMPL software. System symbols are assigned to the following: 

Workspace registers and PC. WP and ST of the target system 

limulator bits 

Trace module constants 

System values and masks 

Names of user commands 

Keywords used as operands of user commands. 

The user may not delete system symbols, nor add symbols to the set of system symbols. The 
user may alter the values of some system symbols. The system symbols, which are reserved 
words, are listed in Appendix E. Use of specific system symbols is described with the AMPL 
statements and user commands to which the symbols apply. 

4.2.3.3 Load Module Symbols. Symbols from a source program may be defined when the object 
module is loaded, and may be used in AMPL statements. Optionally, the following types of 
source code symbols may be defined: 

• The module identifier (operand of the IDT directive) 

• External definitions (operands of DEE directives) 

• Unresolved external references (operands of REE directives). 

These load module symbols may be used until symbols from another module are loaded, or until 
the symbol table is cleared by command. The assembly language allows up to eight characters for 
the module idenUfier; the AMPL loader truncates the identifier to the first six characters. When 
using a module identifier in an AMPL statement, enter a period following the identifier as 
follows: 

MYPROG. 
SINTST. 

When using either an external definition or an unresolved external reference in an AMPL 
statement, precede the definition or reference with a period, as follows: 

.START 
.INBUFF 

4.2.4 ARRAYS. The AMPL language supports one- and two-dimensional arrays (paragraph 4.6.1 ) 
consisting of groups of elements that are referenced by the array name and one or two expressions 
in parentheses. Each element of an array may be assigned a value and may be used as a variable in 
an AMPL expression. A one-dimensioned array is a group of elements arranged in a row or list 
and specified by their position in the row. A two-dimensioned array is a group of elements 
arranged in rows and columns and specified by a row and column position. The following are 
valid references to elements of arrays: 
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NUM(4) The fourth element of array NUM. 

VAL(I) An element of array VAL specified by the value of variable I. 

TABLE (4, 6) The element of array TABLE in row 4 of column 6. 

INPUT(A,B) The element of array INPUT in the row specified by the value of A 

of the column specified by the value of B. 

4.2.5 CHARACTER STRINGS. A character string is written as a string of up to 64 characters 
enclosed in single quotes. When a single quote is required as a character of the character string, 
two consecutive single quotes are entered to specify the single quote. The characters are 
represented internally as eight-bit ASCII characters with the leading bit set to zero. When a 
character string is entered as a statement, it is displayed as a message or comment. This is 
particularly useful when statements are written on a file to be entered with a COPY command 
(paragraph 5.7.14). The following are valid character strings: 

'MAIN' 

'INFILE' 

':OUTFIL/OBJ' 

4.2.6 COMMENTS. A comment may either be added following an AMPL statement or entered 
as a separate AMPL statement. In either case, two consecutive periods introduce the comment, 
and a carriage return terminates the comment. The following are examples of vahd comments: 

TEST PROGRAM LOOP 1 
ECMP (IAQ,>1JH)).. SET BREAKPOINT FOR INSTRUCTION ACQUISITION AT ADDRESS >m 

4.3 NOTATION 

The notational conventions used in the syntax definitions in the manual are as follows: 

• Words shown in capital letters are reserved words (keywords). Reserved words and 
special characters must be entered as shown. 

• Words enclosed in angle brackets represent constants, symbols, expressions, or charac- 
ter strings supplied by the user. 

• Items enclosed in brackets ([] ) are optional. 

• Alternative items are enclosed in braces ( | [ ). One must be chosen. 

• The elhpsis (. . .) indicates that the preceding item may be repeated. 

• A slashed lower case b (b) represents a required space character. 

In the examples, the b has the same meaning as in syntax definitions. Responses by AMPL 
software are underlined. 

4.4 FORMAT 

AMPL software prints a question mark as a prompting character whenever it is ready to receive 
an AMPL statement or command: 
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111 statements and commands, each reserved word, constant, or symbol must be followed by one 
or more spaces to separate these AMPL elements, in this document, carriage return means the 
operation associated with keys marked RIITURN or NEW LINH on various devices. Tiie user 
must enter a carriage return to terminate each line. 

When a statement requires more than one line, either because of the length of the statement or 
to show the statement structure more clearly, a compound statement must be used. 

4.5 EXPRESSIONS 

An expression consists of a constant, a symbol, a subexpression, an array element, or a series of 
constants, symbols, subexpressions and/or array elements separated by arithmetic, logical, or 
relational operators. Each constant, symbol, subexpression or array element may be preceded by 
any of the unary operators. 

4.5.1 SUBEXPRESSIONS. A subexpression is an expression enclosed in parentheses. A 
subexpression is evaluated before evaluating the expression that contains the subexpression. ^^ 
Subexpressions may contain other subexpressions; the innermost subexpression is evaluated first. ^^ 

4.5.2 ARITHMETIC OPERATORS. The arithmetic operators of AMPL perform integer arith- 
metic. The operators are: 

Operator Operation 

+ Addition 

Subtraction 
* Multiplication 

/ Division 

MOD Remainder 

The following are expressions using arithmetic operators: 

2 * (START + 4) The product of 2 times the sum of START plus 4 

LCNl/2 The quotient of LCNl divided by 2 

LCN1)6M0D)62 The remainder obtained by dividing LCNl by 2 

TABEND-TABST The difference of TABEND minus TABST 

4.5.3 LOGICAL OPERATORS. The following logical operators are used in AMPL expressions: 

Operator Operation 

AND Logical product 

OR Logical sum 

The following are examples of expressions using logical operators: 
CHARINliS AN DAMASK 

LCHARtiORJiRCHAR 
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4.5.4 RELATIONAL OPERATORS. The following relational operators are used in AM PL 
expressions: 



Operator 
EQ 
NE 
LT 
LE 
GT 
GE 
HI 
HIE 
LO 
LOE 



Relation 

Equal to 

Not equal to 

Arithmetic less than 

Arithmetic less than or equal to 

Arithmetic greater than 

Arithmetic greater than or equal to 

Logical higher than 

Logical higher than or equal to 

Logical lower than 

Logical lower than or equal to 



The following are examples of expressions using relational operators: 
DAY)iJGE)i534jl 
HOUR)4LT012 
COUNTlj!5HIEj!5COUNT2 
4.5.5 UNARY OPERATORS. The following unary operators are used in AMPL expressions: 

Operator Operation 

+ Plus 

Negation 
NOT One's complement 

(a' Indirect 

More than one unary operator may be used with a symbol, constant, or subexpression, and the 
operators may appear in any order. The operations are described in the following paragraphs. 

4.5.5.1 Plus. The unary operator + performs no operation on the constant, symbol, or sub- 
expression to which it applies. It is included to provide uniformity. 
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4.5.5.2 Negation. Tlie unary operator ~ specifies negation ol the value of the symbol, constant, 
or subexpression to which it applies. The negation is equivalent to the result of subtracting the 
value from zero. The following are examples of negation: 

-248 The result is -248. 

->FE The result is FF02,6 (two's complement) of -FT, ^ .-254. 

4.5.5.3 One's Complement. The unary operator NOT specifies tlie one's complement of the 
value of the symbol, constant, or subexpression. The one's complement is equivalent to substi- 
tuting zeros for ones and ones for zeros in the binary representation of the value. The following 
are examples of one's complements: 

N0T)6>F1F(5 The result is OEOFj e . 

N0T)6FI VE Assuming symbol FIVE has been assigned the value 5 , the 

result is FFFA) (,. 

4.5.5.4 Indirect. The unary operator @ accesses a location in target system memory using the 
value of the symbol, constant, or subexpression as an address. The @ operator specifies "the 
contents of. The following are examples of indirects: 

(a>l(50 The result is the value in location lOOjg of target mem- 

ory. 

@START The result is the value in a location in target system mem- 

ory. The value assigned to user symbol START is the 
target system memory address. 

(3@WRKSPC The result is the contents of the contents of a location in 

target system memory. Assuming that WRKSPC has been 
assigned the value of the workspace address, the result is 
the contents of the location at the address in workspace 
register 0. 

Indirect Addressing Example. Assuming that LCNl has been assigned the value 0106,6, and that 
target system memory contains the following values: 

Target System Memory Address Contents 

(Hexadecimal) (Hexadecimal) 

0106 OlOC 

0108 0001 

OlOA 0002 

OlOC 0003 

OlOE 0004 

The values of the following expressions are: 

@LCN1 010C,6 

micm 0003,6 

@(LCNl+4) 0002,6 
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Target System Memory Addressing. The emulator contains a 256-word trace memory and a 
4K-word user memory. These memories are accessible at addresses in the target memory address 
space under control of logic in the emulator. Figure 4-1 illustrates the mapping of the address 
space to emulator or target system memory. System variable ETM maps addresses FEOOie 
through FFFF15 into emulator trace memory when it is set to one, and into target system 
memory when it is set to zero. System variable BUM maps addresses OOOO15 through 1FFF,6 
into emulator user memory when it is set to one, and into target system memory when it is set 
to zero. References to target memory in this document may be either target memory or 
emulator memory depending on the address and the current values of system variables EUM and 
ETM. 

4.5.6 EXPRESSION EVALUATION. Table 4-1 shows the hierarchy of the operators used in 
AMPL expressions. In evaluating an expression, level 7 operations are performed first, followed 
by operations at successively lower levels until the entire expression has been evaluated. 
Operations at the same level are performed in left to right order. 

The following is an example of an expression: 

42 + 5 * 8 / 4 

The hierarchical levels of the operations are 5, 6, and 6, from left to right. The leftmost level 6 
operation, 5*8, is evaluted first, and the result is 40. The other level 6 operation becomes 
40 / 4, or 10. The expression is now 42 + 10, or 52. Had the expression been: 

(42 + 5) * 8 / 4 

the subexpression (42 + 5) or 47 would have been evaluated first. The multiplication would be 
next, 47 * 8, or 376. The division would be last, 376 / 4, or 94. 



TARGET MEMORY 

ADDRESS 
(HEXADECIMAL) 

0000 



MAPS INTO 



IFFF 
2000 



FDFF 
(3DFF) 

FEOO 
(3E00) 



FFFF 
(3FFF) 




TARGET MEMORY 
(EUM = 0) 



EMUl-ATOR USER MEMORY 
(EUM = 1 ) 



TARGET MEMORY 



TARGET MEMORY 
(ETM = 0) 



EMULATOR TRACE MEMORY 

(ETM = 1 ) 



(A)l 36539 NOTE: 



IN THE TARGET MEMORY ADDRESS COLUMN, TMS 9900 ADDRESSES ARE SHOWN. 
ADDRESSES FOR THE TMS 9980 ARE SHOWN IN PARENTHESES WHERE TMS 9980 
ADDRESSES DIFFER. 



Figure 4-1. Target Memory Address Mapping 
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Table 4-1 . Hierarchy of Operations in Expressions 

Hierarchical Priority Operator Description 

7 
7 
7 
6 
6 
5 
5 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
3 
2 
2 



In evaluating an expression, the carry that can occur during a + or - operation is stored m system 
variable MDR. The carry occurs when there is a carry out of the sign bit position of the 16-bit 
result of the operation. MDR is set to during either operation when no carry occurs, and to 1 
when a carry occurs. To use the carry (as in double-precision arithmetic, for example) the user 
must test the contents of MDR following each -i- or - operation, because the current contents ot 
MDR is the state of the carry bit resulting from the most recent operation. 

4.6 STATEMENTS 

The AMPL language supports the following statements: 

ARRAY statements 

Assign statements 

Display statements 

IF statements 

CASE statements 



(a; 


Indirect 


+ 


Unary plus 


- 


Unary minus (negation) 


* 


Multiplication 


/ 


Division 


- 


Subtraction 


+ 


Addition 


LT 


Arithmetic less than 


LE 


Arithmetic less than or equal 


EQ 


Equal 


NE 


Not equal 


GE 


Arithmetic greater than or equal 


GT 


Arithmetic greater than 


HI 


Logical high 


LO 


Logical low 


HIE 


Logical high or equal 


LOE 


Logical low or equal 


NOT 


One's complement 


AND 


Logical product 


OR 


Logical sum 
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• WHILE statements 

• REPEAT statements 

• FOR statements 

• Compound statements 

• ESCAPE statements 

• NULL statements 



4.6.1 ARRAY STATEMENTS. An ARRAY statement declares one or more arrays. The syntax 
for an ARRAY statement is as follows: 

?ARRAY|6<array name>(<expr>[,<expr>] )[,<array name>(<expr>[,<expr>])] ... 

An array name is a user symbol that is to be the name of an array. It is followed by one or two 
expressions within parentheses. One expression is entered for a one-dimensioned array. The value 
of the expression is the number of elements in the array. Two expressions separated by a comma 
are entered for a two-dimensioned array. The value of the first expression is the number of rows 
of elements in the array. The value of the second element is the number of columns of elements 
in the array. Several arrays may be declared in an ARRAY statement. The length of the line is 
the limit of the number of arrays that may be defined in one statement. 

An array must be declared in an ARRAY statement before any element of the array may be 
referenced. Declaring an array causes the AMPL software to reserve space for the array and 
assigns the value of zero to every element in the array. Once declared, an array is global, 
applying to ail programs being tested, until the symbol table is cleared. The space assigned to an 
array may be made available for other purposes by deleting the array, but the array name may 
only be used as the name of an array of the same number of dimensions until the symbol table 
is cleared. Following deletion, a one-dimensioned array may be declared again with a different 
number of elements, or a two-dimensioned array may be declared again with different numbers 
of rows and columns. 

The following are examples of ARRAY statements: 

? ARRAY NUM (7) Declares array NUM consisting of 

seven elements. 

? ARRAY TABLE (5,1$) Declares array TABLE consisting of 

50 elements arranged in five rows and 
ten columns. 

? ARRAY VAL(8),INPUT (6, COLS) Declares array VAL consisting of eight 

elements, and array INPUT consisting 
of 6 rows. The value of variable COLS 
is the number of columns in array 
INPUT. 
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4.6.2 ASSIGN STATEMENTS. An assign statement assigns a value to a user variable or a system 
variable. The syntax for this type of assign statement is as follows: 

?<symbol>=<expression> 

The interpreter evaluates the expression and assigns the value to the symbol, a user symbol or a 
system symbol. An assign statement defines a user symbol when it assigns a value to a user 
symbol that has not been previously defined. An assign statement that assigns a value to a user 
symbol that has been defined alters the value of the symbol. In either case, the value of the 
expression is assigned to the symbol. The following are examples of this type of assign 
statement: 

? I TN - >1(1I4 Assigns the value 104,6 to user sym- 

^ LUM - ly/H ^^j ^^^ j^ ^^^ .^ ^^^ defined, also 

defines LCN as a user symbol. 

?PC = LCN + 4 Assigns the sum of the value of LCN 

~ plus 4 to system variable PC (target 

system program counter). 

Another form of the assign statement assigns a value to a target system memory location. The 
syntax for this form of the assign statement is as follows: 

2_ @<symbol>=<express1on> 

The C"! sign identifies the value of the symbol as an indirect address. The symbol may be a user 
symbol or a system symbol, and may be preceded by any of the unary operators. The following 
are examples of this type of assign statement: 

? @LCN = 23 Assigns the value 23 to the target 

~" system memorv location specified in 

LCN. 

? @WP = 548 Assigns the value 548 to the target 

~ system memory location contained in 

WP. This location is workspace regis- 
ter 0. 

A constant may be used to specify the target system memory address to which a value is 
assigned. The syntax for this type of assign statement is as follows: 

]_ @<constant>=<expression> 

The ("' sign idenfifies the constant as an indirect address. The following are examples of this form 
of assign statement: 

? @(51# = #INC R(fi# Assign the value corresponding to the 

~ increment workspace register in- 

struction to target system memory lo- 
cation lOOi 6- 

? @>EF(Jl(J = 256 Assigns the value 256 to target system 

"" memory location ELOOi 6 . 
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An expression within parentheses may be used to specify a target system memory address to 
which a value is assigned. The syntax for this type of assign statement is as follows: 

? (3(<expr l>)=<expr2> 

The @ sign identifies the value of the expression within parentheses as an indirect address. The 
following are examples of this type of assign statement: 

?. @(LCN + 8) = @LCN Place the contents of target memory 

location LCN in target memory loca- 
tion LCN -I- 8. 

?_ @(WP + 16) = 345 Place the value 345 into target system 

memory location corresponding to the 
sum of the contents of the workspace 
pointer register plus 16. This location 
is workspace register 8. 

?@(START+4) = #MOV *R0+,*R1# Assign the value of an instruction con- 

stant to location START -t- 4 in target 
system memory. 

An assign statement may be used to assign a value to every element of an array by entering the 
array name followed by the equal sign and the value to be assigned to the elements of the array. 
The following are examples of this type of assignment statement: 

?_NUM = 25 Assign the value 25 (19,6) to all 

elements of array NUM. 

?TABLE = (&10il Assign the value 100, g to all elements 

of array TABLE. 

The assign statement may be used to assign a value to an element of an array by entering the 
array name with one or two expressions in parentheses to specify the element of the array. The 
following are examples of this type of assign statement: 

?^NUM(3) = (JD Assign the value 0,6 to the third 

element of array NUM. 

?_TABLE(3,2)=(J4(60 Assign the value 400, ^ to the element 

at row 3 of column 2 of array TABLE. 

4.6.3 DISPLAY STATEMENTS. A display statement displays the value of an expression. The 
syntax for a display statement using default display options is as follows: 

?_<expression> 
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Tl,e value of the expression determines the variable or location to be displayed. The following 
are examples of display statements using default options: 

7, Ql^-^ Prints value of user variable LCNl as a hexa- 

LCNT = >(Ill(2)4 decimal number (default). 

,pp Prints value of system variable PC (target sys- 

PC ~ = >(tl(6C ^^"^ Program Counter). 

?>200 + 46 ^""*^ ^'^^ ^^'"^ °^ ^'^^' expression. 

>g)22E 

?@>20|S Prints value in location 200,6 of target 

>343^A system memory. 

?#JNE $-8# Display the value of an instruction constant. 

>16tA 

?,^y[vi(2) Display the value of element 2 of array NUM. 

4 6.3.1 Format Specification. The display statement may include a format specirication for the 
display The form of the display statement shown in the preceding paragraph uses the de tau t 
vllue The following is the syntax for a display statement using tormat specification characters. 

?<expression>:<fonnat>. . . 

The expression has the same significance as in the syntax previously described. The colon 
indicates that one or more format specification characters tollow. 

The tormat specification characters are listed m table 4-2. An H specifies printing the displayed 
vmbol ol owed by a^ sign. When it is used. E should precede any other tormat character 

i;:^^:e d!l::::^ers irefLtive In the order in which they are ---^^^l^n the expression to 
be displayed is an expression other than a single symbol, tormat character E is ignored. 

r- t .h-.r-, -t^r R ^necitles a display in binary format, consisting of a less tlian character «) 

olS^d ^16 b':^ i^s (0^;; 1 and two spaces. When the B ,s followed by an opfonal 
S througl 9 that number of binary digits (starting with the least sigmiican d.gi ) s 
diavef The specified number of digits ,s preceded by a less than character -- « '-- ^^J; 
two paces. When the B is followed by the digit 0. the display consists ot a k- han character 
and \l binary digits with no spaces separating the display from the tollowing display. 

I ormat character D specifies a display m decimal format, consisting of a space or imnus sign, 
o c to tlve dec-mal digits (0 through 9,. and two spaces. Leading zeros are replaced by spaces. 
AMPL software converts the contents of tlie word as a two s complement value. 

When the I) >s followed by an optional digit 1 through 5. that number of deamal ^^^^^^ ^^^^^'^ 
whte least significant digit) .s displayed. The specified number ot digits is preceded by a 
; ce o n Js "ul toUowed b two spaces. When the D is tollowed by a digit (, through 
9 tl e 1 o n 1 display occurs. When the 1) is followed by a 0, the norma display occurs but the 
two tra ling spaces are omitted; no spaces separate the display from the tollownig d,spla>. 



• 
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Table 4-2. Format Specification Characters 

Character Type of Display Note 

E Symbol and equal sign 

B Binary 1 

D Decimal 1 

U Unsigned decimal 1 

H Hexadecimal 1 

Octal 1 
A ASCII 

N Line feed and carriage return 2 

X Space 2 

1 Instruction 

S Symbolic address 

Notes: |. May optionally be followed by a single digit 0-9 to specify the 
number of digits to be displayed. 

2. May optionally be followed by a single digit 1-9 to specify the 
number of repetitions of the operation, or a single to specify ten 
repetitions. 



Format character U specifies a display in unsigned decimal format, consisting of one to five 
decimal digits and two spaces. Leading zeros are replaced by spaces, and the word is converted as 
an unsigned magnitude value. The U may be followed by a digit, which has the same significance 
as for decimal displays. 

Format character H specifies a display in hexadecimal format, consisting of a greater tlian 
character (>) foUowed by four hexadecimal digits (0 through 9, A through F) and two spaces. 
The H may be followed by a single digit. When the digit is 1 through 4, the display consists of 
the greater than character followed by the specified number of digits and two spaces. When the 
digit is 5 through 9, the normal display occurs. A results in a display consisting of a greater 
than character and four hexadecimal digits, with no spaces separating the display from the 
following display. 

Format character O specifies a display in octal format, consisting of an exclamation point (!) followed 
by six octal digits (0 through 7) and two spaces. When the O is followed by a digit I through 6, that 
number of octal digits (starting with the least significant digit) is displayed. The digits are preceded by 
an exclamation point and followed by two spaces. When the O is followed by a digit 7 through 9, the 
normal display occurs. When the O is followed by a 0, the normal display occurs but the two trailing 
spaces are omitted; no spaces separate the display from the following display. 

Format character A specifies a display in ASCII format. The 16-bit value of the expression is 
translated into two 8-bit ASCII characters. A period is printed for the contents of any byte that 
does not contain a printable ASCII character. 



4-17 



Digital Systems Division 



.m 



. jj. , 946244-9701 



I-orinat cliaracter N causes a line feed and carriage return between displays. When the optiona 
digit follows the N. the digit specifies a number of line feed and carriage return operations to hi 
performed. The digit specifies ten operations. 



Similarly, format character X provides an additional space between displays and may be followed by a 
decimal digit to provide up to ten spaces (a specifies ten spaces). 



IS 



The I format character specifies the instruction display, which decodes the value as a machine 
instrucfion and displays the mnemonic operation code and operands as tiiey could be specified in 
an assembly language statement. Further explanation and examples of the instruction display are 
included in the next paragraph. 

The S format character specifies a display of a symbolic address when applicable. The symbolic 
addresses are the module identifier, external definitions, external references, and addresses 
relative to the module identifier. The module identifier, external definitions, and unresolved 
external references are optionally loaded with the program. 

The value of an expression to be displayed in the S mode is compared to the load module 
symbols, and the symbol having the same value is printed. When the value of the expression is 
not equal to the value of any load module symbol, the module identifier is printed followed by 
a plus sign and the hexadecimal address relative to the module identifier value (load address). In 
any of the following instances, the S display is replaced by an H display because the S display is 
not applicable; 

• No module has been loaded. 

• Module was loaded without defining load module symbols. 

• Load module symbols have been deleted. 

• Expression value is below lowest address or above highest address loaded. 

The initial default value of the format specification is HH, which specifies displaying the s\ iidx)!, 
the equal sign, and the value is hexadecimal format. The user may enter one or more lornuit 
characters following the colon. When more than one tormat character follows the colon, the 
characters apply in the order in which they are entered, liie following are examples of display 
statements with several format characters: 

?_>4154:ANDH0NB 
AT 
1_6724 >4154 1040524 



?PC:EHX2EBX4ED 
PC ~ = >M£ PC = <HHH^lHUlUi!) PC = 270 

20100 :D303B9 
256 !400 <1 



?^>FFFF:DU 
-1 65535 

70104: DUS Assuming load module MYPROC. is loaded at location IOOk, 

260 260 MYPROG.+ 
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4.6.3.2 Instruction Display. The I format character causes the AMPL software to decode the 
value of the expression as a machine instruction. When the value decodes to an ihegal operation 
code. AMPL software interprets the value as data, and lists a DATA directive witii the 
hexadecimal equivalent of the value as the operand. When the value decodes to a two- or 
three-word instruction, AMPL software supplies one or two words of zeros and displays the 
result. The following are examples of display statements with I format characters; 

MOV Rg.Rgl 

?_>CFFF:I 
MOV *R15+.*R15+ 

1«E3:I 
DATA >00E3 

?_>C802:I 
MOV R2,g>0000 

The software computes and stores the source and destination addresses as it decodes a value 
when the I character has been specified. System variable SRC contains the source address, and 
system variable DST contains the destination address. When the instruction does not have a 
source address, SRC is set to FFFF,6, and when the instruction does not have a destination 
address, DST is set to FFFF,6. The contents of variables SRC and DST are derived from the 
contents of the active workspace of the target system, and will only be valid when the 
workspace contents are vahd. When displaying an instruction independently of emulation of the 
program, the user must check that the workspace registers contain the values that they will 
contain when the program is executed. The following example displays a value in the instruction 
mode, and then displays system variables SRC and DST: 

?.>C7CF:I 
MOV R15,*R15 

?.SRC:H 
>FFF8 

?.DST:H 
>23FE 

Memory address FFFSig is workspace register 15, the source address. Workspace register 15 
contains 23FEi6, the destination address. 

AMPL software accumulates the total numbers of TMS 9900 clock cycles and TMS 9900 memory 
accesses for each instruction decoded in the instruction mode. The totals are set to zero following each 
instruction that modifies the program counter (jump or branch). System variable Tl M E is a switch that 
Contois the display of these totals along with the display of each instruction. When Tl M E is set to one 
(using an assign statement), two values are displayed to the right of the line that displays the 
instruction. The leftmost of these values contains the total of clock cycles, and the rightmost value 
contains the total of memory accesses. When a jump or branch is decoded, the totals are cleared 
following the display and an asterisk is displayed to the right of the values. The clock cycle total may be 
accessed as system variable CC and the memory access total may be accessed as system variable MC. 
The totals may be cleared with assign statements. The totals may be translated into time values by 
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multiplying the clock count total by the clock cycle time for the target system and the memory access 
total by the memory access time for the portion ol target memory in which the access occurs. There are 
se\eral cases for which the number of clock cycles and memory access cycles cannot be stated exactly. 
1 he number of clock cycles for a shift instruction with a count of zero is a function of the contents of 
workspace register 0, which is dynamic. The software uses the maximum clock cycle count (52) in this 
case. Also, the conditional jump instructions require more clock cycles when the condition is true than 
w hen the condition is false. The following are examples of statements to set TI M E on, clear the totals, 
and display timing data; 

?JIME = ON 
ICC = 
?.MC = 8 
?_>CFFF:I 
MOV *R15+,*R15+ 

?>cPfn 

MOV m,m 

?^>1000:I 
JMP $+>0gl82 

The formula for translating the timing figures to total TMS 9900 execution times is as follows: 

T=t,(0) (C + W*M) 
in which: 

T = Execution Time 

^cid)) ~ Clock cycle time, typically 0.333 us. 

C == Number of clock cycles (value of CC, left column of example) 

W = Number of wait states per memory access (depends on type of memory) 

M - Number of memory accesses (value of MC, right column of example) 
For the set of instructions in the preceding example, assuming W = 0, the TMS 9900 execution time is: 

T ^ 0.333 * (54 + (0 * 13) = 0.333 * 54 = 17.982 us. 

The formula for translating the timing figures to total TMS 9980 execution times is as follows: 
T = U.(</))(C + (W+ 1)2 * M) 

The symbols in the formula have the same meanings as in the TMS 9900 formula. For the set of 
instructions in the preceding example, assuming W = 0, the TMS 9980 execution time is: 

T = 0.333 * (54 + (0 + I) * 2 * 13) = 26.64 us 

4.6.3.3 Changing Default Format Specifications. The display statement examples in the pre- 
ceding paragraph include display specifications that apply only to the statement in which they 
appear. To change the default value the user may enter a G between the colon and the first 
character of the new format specification. The following are examples of statements that change 
the default format specification: 



4-20 Digital Systems Division 




946244-9701 



• 



_^PC:GHN Change the default format specification to 

•^^^P^ display the value in hexadecimal format and 

provide a carriage return. 

?_PC:GEH Change the default value, restoring the initial 

PC = >34DE format specification. 

4.6.3.4 Displaying Target Memory. An option of the display statement may be used to display 
the contents of a range of locations in target system memory. The following is the syntax for 
the display statement option: 

2<addr>t4TO)6<addr>[:<fomiat>. . .] ?[:<fomiat>. . .] 

Each addr operand may be any valid expression; its value is interpreted as an address in target 
memory. The first format specification appHes to the display of the address; when it is omitted, 
the default format specification apphes. The question mark (?) causes the display of the value of 
the expression to be followed by a display of the contents of the target system memory location 
corresponding to the value. The second format specification applies to the contents of the target 
system memory location; when it is omitted, the default format specification applies. 

The initial default format specification for either the value or the contents is H (for hexadecimal 
display). The user may change the default by entering a G and a new default format specifica- 
tion for either the value or the contents. The following is an example of a display of target 
system memory locations: 

ISTART = >20A6 ..ASSIGN STARTING ADDRESS TO START 

2FINI = >20AE ..ASSIGN ENDING ADDRESS TO FINI 

lSTART|6T0|ilFINI? 
>20A6 / >042e 
>2flA8 / >22A4 
>20AA / >C8e7 
>20AC / >21A6 
>20AE / >C8gl8 

Any valid expression can be used in place of START and FINI; a similar display can be obtained 
using system symbols. Assuming that the program counter contains 20A6i6, the following 
example displays the same data with the I format character: 

?^PC|!5TOt5PC+8?:I 
>20A6 / BLWP g>22A4 
>2gAA / MOV R7.@>21A6 
>20AE / MOV R8,@>21A8 

4.6.3.5 Display and Modify. When used in a display statement having a single expression, the 
question mark allows the user to alter the contents of the target system memory location. 
Alternatively, the user may specify another location to be displayed. The following is the syntax 
for a display and modify statement: 

I addr [ :<format>. . . ]?[ :<forniat>. . . ] 

The addr operand and the format specification have the same significance as in the syntax 
previously described. The difference is that following the display of the requested location, the 
user may enter one of the command characters listed in table 4-3 or an expression in response to 
the question mark printed by the software. The following is an example of a display and modify 
statement which alters the contents of the target system memory location: 
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= <expr> 



Carriage 
Return 



:<format> . 



Table 4-3. Display and Modify Command Characters 

Meaning 

Evaluate the expression following the equal sign and 
place the value in the location that was displayed. T he 
expression is restricted to consist of a variable, a 
constant, or a combination of variables and or 
constants separated by arithmetic operators + or - only. 

Display the location corresponding to the displayed 
contents. Displayed value is used as an indirect address. 

Set the step mode to plus and display and modify the 
next word, or the next instruction when the I format 
character is in effect. 

Set the step mode to minus and display and modify the 
preceding word. 

When the step mode is plus, display and modify the next 
word, or the next instruction when the I format charac- 
ter is in effect. When the step mode is minus, display and 
modify the preceding word. 

Alter the format specification for the contents of the 
target memory location. 

Terminate the display and modify operation. 



Note: When an expression is entered (not preceded by a command character), AMPL 
software evaluates the expression and displays the target system memory loca- 
tion that corresponds to that value. The user may modify that location as if it 
had been entered in a display and modify statement. The expression may be a 
system symbol; e.g., SRC or DST when the I format character appHes. 

2PC?:H 
>2@A6 / >G)42g) ? = >gl460 
>2glA6 / >g46e ? 

The result of this operation is to place 0460i6 in location 20A6i6 of target system memory. 
Alternatively, the user could have entered an instruction constant, as follows: 



?_PC?:H 
2flA6 / 8428 ? = #B 
Zme I 0460 ? 



@22A4# 
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The instruction constant shown in the preceding example is that ot a two-word msti uclu>n FT.tered in 
this mode, an instruction constant provides all words for multi-word instructions L ntenng a cai i lage 
return after the system displays the question mark causes a display of the second word, as follows: 

20A8 / >22A4 ? 

Alternatively, the user could have entered a + instead of the carriage return. The + sets the step mode 
to plus and accesses the next word. The step mode is plus initially, however, and a carriage return also 
accesses the next word. The + is required when the step mode has been set to minus, and it is desired to 
access the next word. The following example shows the result of entering the plus sign: 

>2aA6 / >me<b ? + 

>2e)A8 / >22A4 ? 

The user may display the contents of address 22A4i6 by entering an @. The following example 
shows the result of entering an (§ : 

>20A8 / >22A4 ? @ 
>20A4 / >22D8 ?" 

The user may change the format specification that applies to the target memory contents by 
entering a colon and a new format specification. The new specification does not alter the default 
values; it only applies to the current display. The following is an example: 

>22A4 / 22D8 ? :I 
>22A4 / COC *R8,R13 ? 

The user may display and modify any location in target system memory by entering an 
expression the value of which is a location in target memory. The expression may only contain 
variables, constants, or question marks. Only addition and subtraction operations may be used. 
In this context, the question mark signifies the current target system memory location. The 
following is an example of entering an expression: 

>22A4 / COC *R8.R13 ? ? + >A 
>22AE / >06A0 ? 



User and system symbols are expressions also. When in the instruction mode it is frequently 
useful to display the source address, as follows: 

>22AE / >Q6Agl ? :I 
>22AE / BL @>(ZI074 ? SRC 
>0(II74 / >Q4Cf~T 

The user may terminate the display and modify operation by entering a semicolon, as in the 
following example: 

>0074 / >(Zl4C0 ? ; 
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Using instruction constants in this mode is very effective because all words of the instruction are placed 
in target system memory. However the user must be aware that entering an instruction constant that 
supplies more words than the instruction that was previously stored at the location requires the user to 
enter the rest ol the program again. Similarly, entenng an instruction that supplies fewer words than 
the instruction it replaces requires the user to enter a NOP instruction or two, or to enter the rest of the 
program again. The following is an example of the problem; 

?_0652?:I 
>0652 / MOV R7,@>(I)104 ? = #MOV R7, R12# . . NEW INSTRUCTION USES ONLY ONE WORD 



>0652 / MOV R7, R12 ? 



^0654 / DATA >mU ? = #MOV R8,0(l)l(ll6# . . REENTER NEXT INSTRUCTION 



>0654 / MOV R8,@>(D1(!!5 ? 



>(I)658 / DATA >(|)106 ? = #MOV @040C,(a040E# . . OLD INSTRUCTION USED TWO WORDS 
>0658 / MOV @>(I)40C,@>04(JE ? 



>065E / BLWP (3>(}2(1)6 ? ; . . BACK IN PROPER SEQUENCE-RETURN TO AMPL 



4.6.4 IF STATEMENTS. The IF statement contains one or two statements, one of which is 
executed depending on the result of evaluating an expression. The syntax for the statement is as 
follows : 

nF<expression>|!5THEN)6<statement>[)6ELSE|4<statement>] 

The expression is evaluated as a logical expression, yielding a true or false value. When the 
arithmetic value of an expression is zero, the logical value is false. The logical value of the 
expression is true when the arithmetic value is not zero. Execution of the statement depends on 
the evaluation, as shown in figure 4-2. When the logical value of the expression is true, the 
statement following the word THEN is executed, and another statement is requested. When the 
logical value of the expression is false, the statement following the word THEN is not executed. 
If the optional statement following the word ELSE has been included, this statement is 
executed; otherwise, another statement is requested. 

The statements within the IF statement may be any of the AMPL statements described in this 
section, including other IF statements. The statements may also be any of the user commands 
described in Section V. 
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The following is an example of an IF statement: 
?_IF)6PC)6EQ)6>106)6THEN^R0 = >AAAA 

The example statement executes the assign statement that sets RO to AAAA,6 when PC contains 
106i6- Otherwise, the assignment statement is not executed. 

The following example shows an IF statement with the optional ELSE statement: 

?_IFt5PCi!5NE0>l#^THEN)4@PC:HI|iSELSEk5WPJ5TOt5WP+32:H?:HD 

In the example, the software displays the instruction at the address in the program counter in 
hexadecimal and instruction format when the program counter contains a value other than 
lOOie- When the program counter contains lOOi^, the software displays the contents ot the 
target system workspace in hexadecimal and decimal format. 

4.6.5 CASE STATEMENTS. The CASE statement provides selective execution of a statement 
within a group of statements depending upon the value of an expression. The syntax for the 
CASE statement is as follows: 

?_CASE0<expr>|4OF|6<expr> : : <stnit> ; [<expr> : : <stmt> ;] . . . [(JELSEt5<stnit>] liSEND 
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The expression following the reserved word CASE is evaluated to use in selecting the statement 
to be executed. Reserved word OF is followed by a group of expression and statement pairs 
separated by two colons. When the value of the expression in one of these pairs is equal to the 
value of the first expression, the statement of the pair is executed. When the value of the first 
expression is not equal to the value of the expression in any pair, and the ELSE reserved word is 
included, the statement following reserved word ELSE is executed. When the optional ELSE 
statement is omitted, and the value of the first expression is not equal to the value of the 
expression in any pair, the CASE statement terminates. 

The expression and statement pairs and the ELSE statement may be entered on separate lines; a 
carriage return may be entered at any point following the reserved word OF. The following is an 
example of a CASE statement: 

?_CASE|iCOUNT|iJMOD)l54)[50F Display COUNT in a position on a line 

1? 2: :C0UNT:X9D; according to the remainder when 

1?. 3 : : COUNT : X9X9D ; COUNT is divided by 4. 

1?. 0::COUNT:X9X9X9D; 
1?. ELSE|ziCOUNT:D 

llEND 

The expressions may be entered in any order. An expression equal to 1 could be entered with 
the decimal display of COUNT instead of the ELSE statement shown. It is not necessary that an 
expression and statement be provided for each possible value of the first expression; normally, 
the ELSE statement is executed for more than one value, as in the following example: 

?_CASE)iJVALUE0OF Set FLAG to one if VALUE is equal 

l]_ 25:: FLAG = ON; to 25 or 30; set FLAG to zero for 

1]_ 3(J::FLAG = ON; other values. 

1?. ELSE*5FLAG = OFF 

1?^ END 

4.6.6 WHILE STATEMENTS. The WHILE statement consists of an expression which is evalu- 
ated as a logical expression and a statement that is executed conditionally. The syntax for the 
WHILE statement is as follows: 

?WHILE|6<expression>|6DOt!S<statement> 

The expression is evaluted first, as shown in figure 4-3. When the value of the expression is false 
(zero), the remainder of the statement is ignored, and the software requests another statement. 
When the value of the expression is true (nonzero), the statement following the word DO is 
executed and the expression is reevaluated. As long as the expression remains true, the execution 
of the statement and the reevaluation of the expression are repeated. When the value of the 
expression becomes false, the statement is not executed and the software requests another 
statement. 

The statement following the word DO may be any of the AMPL statements described in this 
section, including another WHILE statement. The statement may also be any of the user 
commands described in Section V. However, execution of the statement should change the value 
of the expression; otherwise, the operation may never terminate. The following is an example of 
a WHILE statement: 



?WHILE|z5COUNT)6LE)«1000DOXCOUNT = COUNT + 2 
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If COUNT were greater than 100, initially, it would remain unaltered. If COUNT were less than 
or equal to 100 initially, it would be incremented by 2 repeatedly until it became greater than 
100. The final value of COUNT is either 101, 102, or its initial value (greater than 100). 

4.6.7 REPEAT STATEMENTS. The REPEAT statement consists of a statement that is executed 
at least once, and an expression which is evaluated as a logical expression. Subsequent execution 
is conditioned on the logical value of the expression. The syntax for the REPEAT statement is as 
follows: 

2REPEAT)6<statement>j6UNTIL)!5<expression> 

The statement is executed and the expression is evaluated, as shown in figure 4-4. When the 
value of the expression is true (nonzero), the AMPL software requests another statement. When 
the value of the expression is false (zero), the execution of the statement and the evaluation of 
the expression is repeated. Execution of the statement continues until the value of the expres- 
sion is true. 

The statement following the word REPEAT may be any of the AMPL statements described in 
this section, including another REPEAT statement. The statement may also be any of the user 
commands described in Section V. However, execution of the statement should change the value 
of the expression; otherwise, the operation may never terminate. 
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Figure 4-4. REPEAT Statement Execution 



The following is an example of a REPEAT statement: 

?_REPEATfe5IFt5TALLY|6LE)50|«THENt5TALLY = 24|!SELSE)i5TALLY = TALLY - l|!SUNTIH5TALLYk5EQ|«0 

The IF statement within the REPEAT statement is executed at least once. When TALLY has a 
negative or zero value, TALLY is set to 24. Otherwise, TALLY is decremented by one. The 
expression TALLY EQ is evaluated. The IF statement is repeated, decrementing TALLY until 
TALLY equals zero (TALLY EQ is true). 

4.6.8 FOR STATEMENTS. A FOR statement assigns a value to a symbol and uses that symbol 
to control repeated execution of a statement. The syntax of the FOR statement is as follows: 



?_FOR^<symbol >=<expr>0TO|i5<expr>[|!5BY)6<expr>] |i5DOt6<stmt; 



The symbol may be a user symbol or a system variable. It is assigned the value of the expression 
that follows the equal sign, as shown in figure 4-5. Next, the software compares the value of the 
symbol to the value of the expression following the reserved word TO, and executes the 
statement following the reserved word DO if the values are not equal. The software then 
increments the value of the symbol by the value of the expression that follows the reserved word 
BY, or by one when the BY expression is omitted. The software repeats the comparison and 
execution of ihe statement until the value of the symbol equals the value of the expression that 
follows the reserved word TO, and then terminates the operation. 
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The statement following the word DO may be any of the AMPL statements described in this 
section, including another FOR statement. The statement may also be any of the user commands 
described in Section V. When the BY expression is included, the difference of the terminal 
expression minus the initial expression must be an exact multiple of the increment expression: 
otherwise, the symbol will never be equal to the terminal value. 

The following is an example of a FOR statement to initialize values in column one of a 
two-dimensioned array: 

?_FOR0INDEX = l^TO)65|6DOt5MATRIX( INDEX, 1) = INDEX 

Execution of the example statement places values 1 to 5 in rows 1 to 5 of column 1 of array 
MATRIX. The following is an example of a FOR statement that uses a BY expression: 

l?ORm --^ 0ti5TOt58|iiBYtii2|6DO)6@(BUFF+N)=0 

This example statement stores zeros in four words of target memory starting at address BUFF. 
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4.6.9 COMPOUND STATEMENTS. A compound statement is a sequence of AMPL statements 
treated as a single statement. The syntax for a compound statement is as follows: 

?_BEGIN0<statement>[[;]<statement>] . . .JiJEND 

The statements following the word BEGIN may be any of the AMPL statements described in this 
section, including other compound statements. The statements may also be user commands 
described in Section V. 

A compound statement may be used at any point to organize statements into a block of 
statements that are executed after the reserved word I:ND is entered. A compound statement 
must be used when a statement cannot be entered on one line. The AMPL structure statements 
(IF. CASE, WHILE, REPEAT, and EOR) provide control over execution of one or more 
statements. By using compound statements within the structure statements a block of statements 
is executed rather than a single statement as shown in the precedmg examples. 

The following is an example of a compound statement: 

T^BEGIN 
11 CC = 0; 
1? MC = 0; 
1?. TIME = ON; 

11 PC0TOt«PC+20?:I; 

12 TIME = OFF; 
1?_END 

Execution of the statement begins when the END statement is entered. The compound statement 
in the example clears the clock and memory cycle counts, sets the system variable TIME ON. 
displays a set of instructions, sets TIME OFF, and terminates, without user intervention. 

The following is an example of the use of a compound statement with an IF statement: 

?.IFbiPC)!5EQt!5>106)!5THEN|;;BEGIN 
1?. CC = 
1?_ MC = 
1?_ PC0TOb5PC+>100?:I 
12.END|6ELSE|6PC:EH 

This example tests system variable PC and executes a compound statement when PC is equal to 
IO616. The compound statement contains two assign statements and a display statement, Tlie 
assign statements clear the clock cycle and memory cycle counts. The display statement displays 
the contents of target system memory locations in instruction format. When PC is not equal to 
!06i(,, the program counter contents is displayed in hexadecimal format. 
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Compound statements may be used within a CASE statement, as in the following example: 

.DISPLAY LINE NUMBER ON 
.LINES 10 AND 20 

.DISPLAY LINE NUMBER 3iji 
.AND START NEW PAGE 



.BLANK LINE NUMBER COLUMN ON OTHER LINES 



The preceding example assumes that the CASE statement is executed repeatedly along with a 
statement that displays a line of data and a statement that increments the line number. In that 
environment, the statement displays a line number on every lOth line and starts a new page on 
every 30th line. 

Similarly, a WHILE statement may include a compound statement, as in the following example: 

?_MAIN = >100 ... INITIALIZE SYMBOL 

?_N = ... INITIALIZE COUNT 

?WHILE|«N^LT|!S8Oj6D0)6BEGIN 
1? @(MAIN + N) = >2020; 
1? N = N + 2 
1?END 

The example stores ASCII spaces (20i6) in 80 consecutive bytes in target system memory. The 
first location is lOOig. 

A REPEAT statement may also include a compound statement, as in the following example: 



?MAIN = >100 .. INITIALIZE SYMBOL 

?_BUFF = >320 .. INITIALIZE ADDRESS 

IN = .. INITIALIZE COUNT 

?_REPEAT|6BEGIN 

!?_ @(MAIN + N) = (a(BUFF + N) 
1?_ N = N + 2 
12END^UNTIL)!SN|!5EQ|i510 

The example copies 5 words of target system memory from an area starting at location BUFF to 
an area starting at the location addressed by variable MAIN. 

The following is an example of a FOR statement that includes a compound statement: 

7F0RHN = 0»5TOtil0)6BY)62|4DOHBEGIN 

17 IFtS(3(DATA+N)»5AND^0!301tiTHEN|iS@(DATA+N):H ..DISPLAY ODD NUMBERS IN TARGET MEMORY 

V> ELSEU'EVEN NUMBER' ..ADDRESSES DATA THROUGH DATA + 10. 

T? (3(DATA+N) = @(BUFF+N) ..DISPLAY "EVEN NUMBER" FOR EVEN NUMBERS 

it END ..MOVE VALUES FROM BUFF THROUGH BUFF + 10 

-7 ..INTO DATA THROUGH DATA + 10. 
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The example tests the contents of 10 target system memory locations starting at address DATA 
for odd numbers and displays the contents if odd, or a message if even. Then the example moves 
the contents of the corresponding location in an area beginning at address BUFF into the 
location. 

4.6.10 ESCAPE STATEMENTS. The ESCAPE statement causes termination of execution of the 
statements in a loop. The loop structures supported by AMPL software are the WHILE, 
REPEAT, and FOR statements. The syntax of the ESCAPE statement is as follows: 

lESCAPE 

When an ESCAPE statement within a loop structure is executed, control passes to the statement 
that would have been executed at normal completion of the loop operation. When an ESCAPE 
statement is entered other than in a WHILE, REPEAT, or FOR statement, the AMPL softwa.. 
issues an error message. 

The following are examples of ESCAPE statements: 

2WHILE)6NtiLEJ5M)(SDOJ5BEGIN 

1? IF|!iDATA+Nt5HIE16>lFFFHTHEN)!SESCAPE ..TEST FOR ADDRESS ABOVE IFFF,.. 
11 (a(DATA+N) = ..STORE ZERO IN ADDRESS ^° 

11 N = N+2 
1? END 

?REPEATtiBEGIN 
l7 IF|!i@(BUFF+N)|iSEQ0>414)6THENt5ESCAPE ..TEST FOR AA IN BUFFER 
1? N = N+2 ..INCREMENT N 

TT PTR = BUFF + N ..STORE NEXT ADDRESS IN PTR 

lTENDt5UNTILtiN=M 

IFORIiCNT = NfciTOIiiMtJDOiiiBEGIN 
_11 IFt!iADDRt6HIEti FFFE)6THENi5ESCAPE ..TEST FOR ADDRESS ABOVE MEMORY ADDRESS SPACE 

12 0ADDR = FFFF ..STORE -1 INTO ADDR 

1? ADDR = ADDR+2 ..INCREMENT ADDR 

1?END 



In each of the examples, the ESCAPE statement terminates the loop when a specified condition 
other than the condition of the loop occurs. 

4.6.11 NULL STATEMENTS. The NULL statement is a no operation statement. The syntax of 
the NULL statement is as follows: 

imii 

The NULL statement may be used at any time a no operation statement is appropriate. For 
example, in a WHILE or REPEAT statement in which the expression depends on a signal from 
hardware to terminate the operation, a NULL statement may be used following DO or RFPEAT. 
respectively. 
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4.7 PROCEDURiiS AND FUNCTIONS 

AMPL supports procedures and functions written by the user. Procedures and functions are 
subroutines available for use in AMPL statements. A procedure is called by a procedure call 
statement and may define one or more arguments to be passed from the calling statement. A 
procedure consists of a definition statement that includes a single executable statement, typically 
a compound statement. A function call is used as a variable, the value of which is the value 
returned by the function. A function may define one or more arguments to be passed from the 
function call. A function consists of a definition statement that includes a single executable 
statement, typically a compound statement. A function should contain at least one return 
statement, either as the only statement, or as a statement within the compound statement. 

The statement of a procedure or function is not executed at the time the procedure or function 
is defined, but is executed each fime the procedure or funcfion is called. It is especially 
important to reahze that an ARRAY statement in a procedure or function is not executed until 
the procedure or function is called. Any reference to an element of such an array is valid only 
after the procedure or function that contains the ARRAY statement has been called. 

4.7.1 PROCEDURE DEFINITION STATEMENT. The procedure definition (PROC) statement 
defines the statement that follows as a procedure and specifies the required number of arguments 
and optionally the number of words of local storage for the procedure. The syntax for the 
PROC statement is as follows: 

2PROC0<procedure name>[(<arguments>[,<local storage>])]<statement> 

The procedure name operand is the name used to call the procedure; it must meet the 
requirements for user symbols listed in paragraph 4.2.3.1, and must be unique with respect to 
other procedure names, function names, array names, and user symbols. The arguments operand 
is an integer constant having a value from zero through 255 that specifies the minimum number 
of arguments required by the procedure. When the procedure requires local storage, the local 
storage operand specifies the number of words of local storage required. The local storage 
operand is a positive integer constant less than 65,536. When the local storage operand is 
omitted, no local storage is provided for the procedure. When both operands are omitted, the 
value of zero is used for both operands. 

The following are examples of PROC statements: 

?PR0C|!5DSPLY (4,10) BEGIN Defines the compound statement as pro- 

cedure DSPLY that requires at least four 
arguments and ten words of local storage 

?PR0C|6NAME (0) 'PROGRAM NAME IS' Defines procedure NAME to print a 

message that identifies the program 
name. 

4.7.2 FUNCTION DEFINITION STATEMENT. The function definition (FUNC) statement 
defines the statement that follows as a function, and specifies the required number of arguments 
and optionally the number of words of local storage for the function. The syntax for the FUNC 
statement is as follows: 

?FUNC|!5< functi on nanie>[ (< arguments>[ ,<1 ocal storage>] ) ]<statement> 
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The function name operand is the name used in the function caU; it must meet the requirements 
for user symbols Hsted in paragraph 4.2.3. 1, and must be unique with respect to other function 
names, procedure names, array names, and user symbols. The arguments operand is an integer 
constant having a value from zero through 255 that specifies the minimum number of arguments 
required by the function. When the function requires local storage, the local storage operand 
specifies the number of words of local storage required. The local storage operand is a positive 
integer constant less than 65,536. When the local storage operand is omitted, no local storage is 
provided for the function. When both operands are omitted, the value of zero is used for both 
operands. 

The following are examples of FUNC statements: 

2FUNCt4LSUM (3,2) BEGIN Defines the compound statement as 

function LSUM that requires at least 
three arguments and two words of local 
storage. 

?FUNC)l5ADDIT(2) BEGIN Defines the compound statement as 

"" function ADDIT that requires at least 

two arguments and no local storage. 

4.7.3 ARGUMENTS. The arguments for procedures and functions are placed in the call 
statement or function call. At least as many as are specified in the definition must be supphed. 
The unary operator ARG is used within the procedure or function to determine the number of 
arguments supplied in the call, and to access the arguments. The constant, variable, or sub- 
expression to which the operator ARG appHes must evaluate to a positive integer value or zero. 
When the value is zero, the result is the number of arguments supphed in the call; when the 
value is a positive value, the operator and its operand access the argument corresponding to the 
value; i.e., ARG 1 accesses the first argument (leftmost argument) in the call, ARG 2 the second, 
etc. The value of the operand of the ARG operator must not exceed the value of ARG 0. The 
ARG operator may be used to access an argument either for reading or writing, unless the value 
of the operand is zero; the value of ARG may not be altered. A value stored in an argument is 
local to the procedure or function, and is not returned to the calling statement. 

The priority of unary operator ARG with respect to the operators listed in table 4-1 is 7 (highest 
priority). The following are examples of the use of unary operator ARG: 

/\R(5^3 Accesses the third argument from the 

left in the set of arguments of a call to a 
procedure or function. 

ARG0N When N has a value greater than zero, 

and equal to or less than the number of 
arguments, accesses the corresponding 
argument. When the value of N is nega- 
tive or greater than the number of argu- 
ments, the expression is invalid. When 
the value of N is zero, accesses the 
number of arguments entered. 
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4.7.4 LOCAL STORAGE. A PROC or FUNG statement that has tiie optional local storage 
operand causes the software to reserve memory for local storage for the procedure or function. 
Local storage is provided each time the procedure or function is called, even though the call is 
nested within another call, and becomes inaccessible when the procedure or function terminates. 
Data cannot be passed between procedures and functions or between a procedure or function 
and the calling statement through local storage. 

The words of local storage are referenced by the unary operator LOG. The constant, variable, or 
subexpression to which the operator LOC applies must evaluate to an integer value greater than 
or equal to zero, and less than or equal to the number of words of local storage provided. When 
the operand evaluates to zero, the result is the number of words of local storage provided. When 
the value is a positive value, the operator and its operand access the word in local storage 
corresponding to the value; i.e.. LOG 1 accesses the first word, LOC 2 the second, etc. The LOC 
operator may be used to access a word for either reading or writing, except that the value of 
LOC may not be altered. 

The priority of unary operator LOC with respect to the operators listed in table 4-1 is 7 (highest 
priority). The following are examples of the use of unary operator LOG: 

LOC|!54 Accesses the fourth word of local storage 

for the procedure or function. 

L0Ct^(NUM+3) When subexpression NUM+3 has a value 

greater than zero and less than or equal 
to the number of words of local storage, 
accesses the word of local storage that 
corresponds to the value. When the value 
of NUM+3 is negative or greater than 
the number of words of local storage, 
the expression is invalid. When the value 
of NUM+3 is zero, accesses the number 
of words of local storage allocated. 

4.7.5 RETURN STATEMENT. The RETURN statement terminates the execution of a function 
or a procedure. The syntax for a RETURN statement is as follows: 

?_RETURN[t4<expression>] 

The expression is evaluated, and when the statement appears in a function, the value is assigned 
to the function call. When the expression is omitted, and the RETURN statement is in a 
function, the value of zero is returned. When the RETURN statement is in a procedure, the 
expression is evaluated but the value is not returned. 

The RETURN statement is valid in a function, either as the only statement in the function, or as 
a part of the compound statement of the function. The RETURN statement is also valid in the 
compound statement of a procedure. The following is an example of a function that contains 
only a RETURN statement: 

1FUNC*5SUM(2) RETURN)«ARG01 + ARG|i52 

This function returns the sum of the arguments as the value of the function call. Other examples 
of RETURN statements appear in examples in paragraph 4.7.7. 
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A lunctioii that ivluiiis a \alue othci tlian zero to llic limctioii call must contain a HI H'KN 
statement. lACCUtion ol a KillJRN statement durnig execution of a procediiie oi lunclion 
terminates execution ot the procedure or lunelion. and returns control to tiie callini; >talenu'nl 
An implicit RTTURN with an operand ot occurs lollowinp the executable statement ol a 
procedure or function. A function that contains no explicit RIHURN statement teiniinates at 
that point and returns a value of zero for the function call. 

4.7.6 CALLS TO PROCEDURES AND EUNCTIONS. A call to a procedure is an AMl'L 
statement consisting of the procedure name followed by arguments, if any, enclosed in paren^ 
theses. The syntax of a procedure call is as follows: 



]<procedure name>[(<argument>[,<argunient>]. . .)] 



Tiie procedure name is a name that has previously been entered as the first operand of a PR(X 
statement. The user must enter the number of arguments specified in the PROC statement, and 
tnay enter as many more as desired. Arguments must be entered in tiie sequence required by the 
procedure Each argument is an expression. 

.'\ procedure call may be entered whenever the software requests a statement, or within an H-, WHll f, 
REPEAT, or compound statement. A call to a procedure may be included in the same proceduie 
(recursive call), in another proceduie. or in a function. 

The following is an example ot a i^rocedure call: 

■^DSPLl {LBLl,LBLl+8) <^ •J":^ procedure DSPLl specitving tvvo 

~ " aiguments. EBLl and LBLl+8. AR<i $ 

within the procedure returns 2. ARCi I 
accesses LBEl, and ARC 1 accesses 
EBEl+8. 

.A call to a junction is u'-ed as a variable m an expression. The value returned In the function 
become-- llie \alue ol the \ariable, 1 iie function call consists ot the function name followed by 
arguments, il any. enclosed in parentheses. The synla.x ol a function call is as follows: 

<function name; [(<argurient>[,<argunient>] . . .)] 

ihe function name is a nanu- tiial has previously been entered as the first isperiind of a ! UNC 
suiiemeni. 1 lie user must Miter the number of arguments Npeeitud ui the i ENC statement .uul 
mav enier as many more ., desiied. Arguineiifs musi be entered ui the seciuenee re(imrei! In the 
lunction. ! aJi argument is an expression. The op,eraiid of' the R1-TUR\ st.itement that 
termiiKile-- execution of the luueiiou becomes the value oi the funetion call. 

A function cail may be used in any AMl'l. expression. ,\ lunction eall may in' iisetl in the sjiiie 
lunelion (leeursive ealll. m another lunction. or in i procedure. Ihe followm.!' :iie examples ol 
AMPL statements that contain lunetion calls: 

?STADD = SUM(BEG1N ,OF£CT) "^ finable STADl) is set to the value of 

-" Ihe SE'M lunciton ot HldlN .iiul 

Ol SEl. 

?SUM(BEGIN,OFSET) + 10:HD Displass the sum of the SEM function 

~ ol Bl (.IN and OI SIT and 1 tfi in hexa- 

decimal and decimal form.u. 
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4.7.7 PROCEDURE AND FUNCTION EXAMPLES. The following is an example of a procedure 
definition: 

?.PROCt!SDT ((^,2) BEGIN .. DUMP EMULATOR TRACE BUFFER (0 ARGUMENTS, 2 LOCAL VARIABLES) 

12 LOCtil = ETBO .. GET INDEX OF OLDEST STORED VALUE 

12 LOC)62 = ETBN .. GET INDEX OF NEWEST STORED VALUE 
1? WHILE)6LOC)61t5LEtSLOCH2|!iDO 
Tf BEGIN 

22 ETB(LOCtSl):H ..DISPLAY TRACED VALUE 

2? (aETB(L0C)61):HIN . .DISPLAY CONTENTS OF TRACED VALUE 

22 LOCIiSl = LOCtSl + 1.. INCREMENT INDEX 

2? END 

11 RETURN ..THIS STATEMENT MAY BE OMITTED 
1?END 



Procedure DT displays the contents of the emulator trace memory. On the assumption that the 
memory locations contain program counter values, the procedure also displays the contents of 
these addresses. The procedure uses a command (ETB) and two system variables (ETBO and 
ETBN) which are described in Section V. The command reads a value from the trace memory, 
and the system variables contain the lower and upper index hmits that define the portion of 
trace memory into which trace values have been stored. 

The PROC statement defines procedure DT with no arguments and two words of local storage. 
The procedure consists of a compound statement that contains two assign statements, a WHILE 
statement, and a RETURN statement. The first assign statement assigns the index value of the 
oldest value in trace memory (system variable ETBO) to LOG 1. The second assign statement 
assigns the index value of the newest value in memory (system variable ETBN) to LOC 2. The 
WHILE statement executes a compound statement repeatedly until local storage word 1 is greater 
than local storage word 2. The compound statement contains two display statements and an 
assign statement. The first display statement displays the contents of a trace memory location; 
the second display statement displays the contents of the displayed address in hexadecimal and 
instruction format. The assign statement increments the contents of local storage word 1 . 

The WHILE statement terminates when the values stored in trace memory have all been 
displayed. The RETURN statement terminates execution of the procedure. If the RETURN 
statement is omitted, the impHed RETURN provided at the end of every procedure terminates 
the procedure. The call for the procedure is as follows: 

2DT; 

The call for a procedure or function can include more arguments than the required number 
specified in the PROC or FUNC statement. Many procedures and functions, such as the 
preceding example, would ignore any arguments (or additional arguments). The following is an 
example of a procedure that requires one argument, but displays results (execution times) for as 
many arguments as the user enters. 
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1PROC0T1MEN (1,1) BEGIN 
11 L0Ct51 = 1 
\± TIME = OFF 
il WHILEtiiLOCt51|!5LE)!5ARG|iiOt5DO 
11 BEGIN 
11 MC = 

11 CC = 

11 @ARG (L0C)!51):IXXXXX 

2]_ 333 * (CC + MC):DN 

11 LOC01 = LOCtSl + 1 

11 END 
llEND 

1 he example computes execution times of 1 MS 9900 instructions (other than branch or jump), 
assuming a clock cycle time of 333 ns and a single wait cycle. 1 lie calling statement includes the 
locations to be displayed for which time is to be computed. 

Procedure IIMFN contains a compound statement consisting olivvo assign statements and a WHIl.h 
statement. llie first assign statement assigns the value of I to L()(~ I to be used as an mdex to the 
arguments. The second assign statement sets system variable liMf: OFI-~ to inhibit printing ol the 
\alues of CC and MC in the display. 1 he WHILE statement causes a compound statement to be 
executed for each argument. Within this compound statement, assign statements clear MC and CC, 
and display statements display the contents of the memory location corresponding to the argument m 
instruction format, and the computed execution time in decimal format. The last statement in the 
compound statement increments the index to access the next argument. The loliowmg are examples ol 
statements that call procedure TIM EN: 

ITI MEN (START) 

niMEN (MAIN+10,MAIN+24,COMP) 

Tlic tnllouinf-' i'- an example ol a function definition: 

?_FUN(,tiMEMTST (3,1) BEGIN .. MEMORY TESTER (3 ARGUMENTS, 1 LOCAL VARIABLE 

22 LO(til = ARGkSl .. SET LOCAL STORAGE WORD TG ST/iRTIUG ADDRESS ARGIif-T'. 

22 WI-;lLC)iLOCt51)6LOEP,RG)62t!SDO .. WRITE PHASE 

22 BEGIN 

2± gfOCtiSl = ARG|!i3 

kj_ L0C(61 = LOCtil + 2 

Zl END 

21 lom = ARGtil ..SET LOCAL STORAGE WURi TO STARTING ADDRESS ARGUMEN: 

21 WMILE^LOC)61|!SLOE)!5ARGtS2|i5DO .. READ AND COMPARE i'HASE 

21 BEGIN 

£l jr|i((3LOCJSlt!SNEt6AR6i63feSTHENt!iR[Tu'RN0LOC01 .. LRRfK EXIT 

!?_ LOCtiil = LOCtil + 2 

2?_ END 

11 RETURNtS-1 .. NORMAL EXIT 
1?END 
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CAUTION 

If the second argument for this function is equal to FFFF,6 or if 
the first argument is an even address and the second argument is 
FFFE16, the function will not terminate properly, and will destroy 
the contents of low order memory if allowed to execute indefi- 
nitely. Incrementing FFFE,6 by 2 results in 0000,6, which is 
lower than either FFFE,6 or FFFFig. 

Function MEMTST tests an area of memory as specified in three arguments. The first argument 
is the starting address in target system memory; the second argument is the ending address. The 
third argument is the test data to be used in the test. 

The FUNC statement defines function MEMTST with three arguments and a word of local 
storage. The function consists of a compound statement that contains an assign statement and a 
WHILE statement for the write phase, an assign statement and a WHILE statement for the read 
and compare phase, and a RETURN statement. The assign statement for the write phase sets the 
local storage word to the starting address in the first argument. The WHILE statement executes a 
compound statement repeatedly until the address in the local storage word is greater than the 
ending address in argument 2. The compound statement consists of two assign statements. The 
first writes the test data word into the target system memory location specified by the local 
storage word. The second assign statement increments the contents of the local storage word by 
two. The WHILE statement terminates when all words in the test area have been written. The 
assign statement for the read and compare phase sets the local storage word to the starting 
address. The WHILE statement executes a compound statement repeatedly until the address in 
the local storage word is greater than the ending address in argument 2. The compound 
statement consists of an IF statement and an assign statement. The IF statement executes a 
RETURN statement if the contents of memory are not equal to the test data in the third 
argument; this constitutes a memory error, and the address in the local storage word (the address 
that contains an error) is returned. When the contents of the memory location are correct, the 
assign statement is executed, incrementing the contents of the local storage word by two. The 
WHILE statement terminates when all words in the test area have been read and found to be 
correct. The RETURN statement provides a normal return, returning a -1 to identify the normal 
return. 

The following are examples of AMPL statements that caU MEMTST: 

?TMTST = MEMTST (START, FINISH, >A5A5) .. TEST MEMORY 
TlFtiTMTSTtiNE|4-l)6THENJ5TMTST:D .. DISPLAY ERROR ADDRESS IF ERROR RETURN 

?_BEGIN 

1?. TSTDAT = >A5A5 ..INITIALIZE DATA FOR TEST 

1?. TSTAD = >tl<l><t ..INITIALIZE STARTING ADDRESS 

12 TSTEND = >im ..INITIALIZE ENDING ADDRESS 

1? WHILE»5TSTAD(5LOKTSTENDt5DOtiBEGIN 

21_ TSTMEM = MEMTST (TSTAD, TSTEND, TSTDAT) .. TEST MEMORY 

2? IF|6TSTMEM|iiEQ|5-l|6THEN 

2? TSTAD = TSTEND .. TEST COMPLETE 

21 ELSEJ5BEGIN 

3?_ TSTMEM:H .. DISPLAY ERROR ADDRESS 

31 TSTAD = TSTMEM +2 .. CONTINUE TEST BEGINNING AT 

31 END .. ADDRESS FOLLOWING ERROR 

21 END 
1?END 
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SECTION V 
SYSTEM OPERATION 

5.1 INTRODUCTION 

Prior to loading and operating the AM PL system, connect the target system to the host system through 
the emulator/ buffer module, the logic state trace data module, or both, as described in the installation 
and operation manuals for these modules. 

Operation of the system consists of loading the operating system, starting the AM PL program, and 
entering AMPL statements and commands. This section includes the loading procedures forTX990 
and for DX 10 and descriptions of the user commands. User commands are described in the following 
categories: 

Target System Program Loading and Saving Commands 

Utility Commands 

CRU Commands 

Data Input Commands 

Emulator Operation Commands 

Trace Module Operation Commands 

5.2 LOADING AND STARTING THE SYSTEM 

Loading and starting the system differs for TX990 and DXIO systems. The following paragraphs 
describe the procedures for the two operating systems. 

5.2.1 TX990. To load the AMPL system, perform the following steps: 

1. Place the AMPL system diskette in either floppy disk unit and place the unit in the Ready 
mode. 

NOTE 

Place the system disc in floppy disc unit 1 (left-hand unit), if possible. 
When the system disc is in unit 2 a limited set of error messages is 
printed (paragraph 6.2). 

2. Press the HALT/SIE switch on the programmer panel of the computer. 

3. Press the RESET switch on the programmer panel. 

4. Press the LOAD switch on the programmer panel. 

5. The computer should load TX990 from the diskette and print a message similar to the 
following when the loading has completed: 

TX990 SYSTEM 

MEMORY SIZE (WORDS): 24576 AVAILABLE: 12923 



5-1 Digital Systems Division 



946244-9701 



6. When a Model 9 1 1 VDT is used as system console, verify that the UPPER CASE LOCK key 
is in the upper case position for proper entry to TXDS and to the AM PL program. 

7. Enter an exclamation point (!) to activate the Terminal Executive Development System 
(TXDS). The computer prints a message similar to the following: 

TXDS 936215** 1/0 0:0 

PROGRAM: 

8. Place FS990 TXDS parts diskette in the other floppy disk unit (normally unit 2) and enter 
the following information to execute utility SYSUTL to initialize time and date. (If time and 
date information is not required, steps 8 and 9 may be omitted.) The following example 
shows entering data corresponding to 3:45 p.m., March 11, 1977: 

PROGRAM: DSC2:SYSUTL/ SYS 

INPUT: 

OUTPUT: 

OPTIONS : ID,1977,3, 11,15,45. 

9. SYSUTL executes the command, prints the following message, and returns control to 
TXDS: 

TX990 SYSTEM UTILITY 937544** 

15:45:00 MAR 11, 1977 

10. After executing the ID command, SYSUTL terminates. Control returns to TXDS, which 
prints a message similar to the following: 

TXDS 936215** 70/77 15:45 

PROGRAM: 

1 1. Enter the program name, followed by an asterisk. The asterisk specifies that the entry of 
input, output and options is not required. Enter the name as follows: 

PROGRAM: :AMPL/SYS* 

12. The program begins execution, and prints a question mark requesting entry of a user 
command or an AM PL statement. The program is initialized to provide space for 30 user 
symbols. The user may require more than 30 symbols, or may not require that many. When 
fewer than 30 user symbols are required, specifying a smaller number allows more memory 
for procedures and functions. When deciding on symbol table requirements, allow space for 
module names and procedure and function names. The user may enter a CLR command 
with a positive integer operand to specify user symbol table size. The following is an example 
of a CLR command: 

^ CLR (25) Reserve space for 25 symbols in the user symbol 

table. 

13. Enter commands and statements as required. The program prints a question mark 
requesting entry at the completion of each command or statement: 
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5.2.2 DXIO. To load the AM PL system, perform the following steps: 

1. Place the disk cartridge containing the DXIO system and the AMPL program on system 
disk unit 0, and place the unit in ready with write protection disabled. 

2. At the programmer panel of the computer, press the HALT/SIE switch. 

3. Press the RESET switch on the programmer panel. 

4. Press the LOAD switch on the programmer panel. 

5. When a Model 911 VDT is to be used as AMPL terminal, verify that the UPPER CASE 
LOCK key is in the upper case position for proper entry of System Command Interpreter 
commands and AMPL commands and statements. 

6. Press the blank orange key (upper right of keyboard) on the Model 91 1 VDT. 

7. Enter an exclamation point (!). The system displays a pair of brackets ([ ]) requesting entry 
of a command. 

8. Enter IS for an initialize system command. The system displays the following: 

INITIALIZE SYSTEM 
INITIALIZE SYSTEM LOG?: 

9. Enter YES. The system displays the following request: 

YEAR: 

10. Enter the current year; e.g., 1977. The system displays the following request: 

MONTH: 

11. Enter the number of the month; e.g., 9 for September. The system displays the following 
request: 

DAY: 

12. Enter the day of the month; e.g., 13. The system displays the following request: 

HOUR: 

13. Enter the hour (adding 12 to P.M. hours); e.g., 17 for 5 P.M. The system displays the 
following message: 

MINUTE: 

14. Enter the minute; e.g., 35. The system displays the following request: 

ATTENTION DEVICE: 
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1 5. Hnter the device name of a terminal on v\ hich t lie system displays attention messages, or M i: 

if the messages are to be displayed on the AM EM. terminal. The system displays the following 
request: 

LOGGING DI-VICE: 

16. Enter DUMY or the device name of a device to display system log messages. The system 
displays the following request: 

FILES?: 

17. Enter YES. The system displays the following request: 

PRIMARY FILE: 
IK. Enter 0. The system displays the following request: 
INITIAL ALLOCATION: 

19. Enter 100. The system displays a pair of brackets requesting another command. 

20. Enter AMPL to activate the AMPL program. The system displays the following: 

AMPL MICROPROCESSOR PROTOTYPING LAB 
USER MEM (K)-= 8 

21. Either enter another number instead of 8 and press the RETURN key, or press the 
RETURN key to specify 8. The number is the size in 1024 ( I K) word blocks of memory 
required for the AMPL system data and work area. The user may specify less than 8 when 
the work to be done does not require many procedures or functions and other users and 
other tasks require system resources. The user must specify more than 8 when the work to be 
done requires many long functions and procedures. The systemdisplays the following (with 
the applicable version number): 

AMPL 3.0 



22. If a symbol table size less than or greater than 30 symbols is required, enter a CT.R command 
similar to the following to specify a symbol table size. When few symbols are required, a 
small symbol table provides more memory for procedures and functions. When deciding on 
symbol table requirements allow space for load module symbols and for procedure and 
function names. The CLR command is as follows: 

_? CLR (45) Reserve space for 45 symbols in the user symbol 

table. 

23. The A.MPL system displays a question mark (') to request a command or statement at the 
completion of execution ol each command orsiatement. Entercommandsand statementsas 
required. 
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5.3 HARDWARE DEMONSTRATION TEST 

The AM PL software includes a hardware demonstration test that verifies the installation of the 
emulator and trace modules. It should be executed following the initial loading of the AM PL program. 
The hardware demonstration test is not a diagnostic test of the emulator and trace modules. However, 
it may be executed at any time you desire to exercise the emulator and trace modules. Perform the 
following steps to execute the test immediately after loading and starting the AMPL program: 

1 . Enter a COPY command to load the test. Use the applicable one of the following examples, 
followed by a carriage return: 

2 COPY (':AMPHDT/PRC') For a TX990 system, or 

? COPY ('.SSSYSLIB.AMPLSLIB.AMPHDT') For a DXIO system. 

2. When the AMPL program has loaded the procedures for the test, it displays operating 
instructions. Follow the instructions in each display, entering the following as requested. 

^C 

3. When C is entered following the third group of instructions, the test begins. The first test 
consists of displaying instructions for entering the EINT command to initialize the 
emulator. Use the applicable one of the following examples: 

_? EINT ('EMU') TX990 system 

lEINT('EMOr) DXIO system 

4. The AMPL software responds by displaying a question mark when the initialization 
completes satisfactorily. The system displays an error message when initialization fails. A 
typical error that might occur during an initialization attempt displays the following 
message: 

*** ERROR 205>0700>000l 

EMULATOR DSR ERROR: 

>02XX = ILLEGAL OPERATION 
>06XX = OPERATION TIMED OUT 
>07XX = DEVICE ERROR 

If any error message is displayed, verify the connections to the emulator, and verify that the 
emulator module is firmly seated in the proper slot. Then repeat the command. 

5. When the emulator has been successfully initialized, enter the following command to resume 
the test: 

? AMPHDT; 

6. The second test displays the following title, and clears and sets the two system variables that 
map target system memory addresses into emulator memory. Normally the test completes 
with no further message. 

-EMULATOR MEMORY SELECTION TEST- 
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F-ailure of the test is indicated by an error message; typically, t he error message shown in step 
4 is displayed. If an error message is displayed, verily that the microprocessor connector ol 
the buffer is not connected to anything, or is not contacting any electrically conductive 
material. Should the microprocessor connector be connected to a target system, both the 
emulator and the target system are being tested. Disconnect the microprocessor connector 
to isolate the problem. 

After successfully completing the second test, the software begins the third test by displaying 
the following title: 

-EMULATOR USER MEMORY TEST (4K WORDS)- 

The test consists of writing the memory address into the addressed location, begmning at 
address 0. The test then reads the tested address, and compares the contents to the address. 
When the comparison is equal, the test continues by adding .32 to the tested address, and 
repealing the test, until the range of addresses, through 1 FE0i6, has been tested. When the 
comparison is not equal, the test displays the following title: 

*** ERROR: EMULATOR USER MEMORY ERROR 

The test may be repeated by entering the following command. If the failure persists, refer the 
problem to maintenance personnel. 

J? AMPHDT; 

After successfully completing the third test, the software begins the fourth test by displaying 
the following title: 

-EMULATOR TRACE BUFFER MEMORY TEST (2.56 WORDS)- 

The test is similar to the user memory test, except that ail even addresses from FEOOi,, 
through FFFE|6 are tested. If the test software detects an error, it displays the following 
message: 

*** ERROR: EMULATOR TRACE MEMORY FAILURE 

Recover from the error as described in step 7. 

After successfully completing the fourth test, the software begins the fifth test by displaying 
the following title: 

-EMULATOR RUN TEST- 

1 he test writes a simple program into target memory, consisting of four instructions, the last 
of which is an IDLE instruction. The test then sets up the emulator to execute with no 
tracing or breakpoint, and issues a command to start the emulator. The program in memory 
executes, placing the microprocessor in the idle mode The test verifies that the 
microprocessor is executing an IDLE, instruction. II the status of the microprocessor 
indicates that the microprocessor is not executing, or is not executing an IDLE instructit)n, 
the test program displays the following message: 

*** ERROR: EMULATOR EXI ( UTION I AILURI 
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If the test fails, refer the problem to maintenance personnel. Repeat the test by entering the 
following: 

? AMPHDT; 

10. After successfully completing the fifth test, the software begins the sixth test by displaying 
the following title: 

-EMULATOR HALT TEST- 

The test executes an emulator command to halt the emulator, and verifies that the emulator 
halts. If the status of the microprocessor indicates that the emulator did not halt, the test 
displays the following message: 

*** ERROR: EMULATOR FAILED TO HALT PROPERLY 

Recover from the error as described in step 9. 

11. After successfully completing the sixth test, the software begins the seventh test by 
displaying the following title: 

-EMULATOR TRACE TEST- 

The test sets up a trace of the program in target memory, and a breakpoint at completion of 
the trace operation. The test then re-executes the program in target memory, and verifies 
that the trace operation traced properly and halted the operation. When the trace operation 
fails, the test displays the following message: 

*** ERROR: EMULATOR FAILED TRACE TEST 

Recover from the error as described in step 9. 

12. After successfully completing the seventh test, the software begins the eighth test by 
displaying the following title: 

-EMULATOR ADDRESS COMPARISON TEST- 

The test sets up a breakpoint at an instruction address, and re-executes the program in target 
memory. The test then verifies that the breakpoint stopped the emulator at the proper point. 
When the breakpoint operation fails, the test displays the following message: 

*** ERROR: EMULATOR FAILED PC BREAKPOINT 

Recover from the error as described in step 9. 

13. At this point, emulator tests have been completed, and the test displays the following 
message: 

*** EMULATOR PASSES HARDWARE DEMONSTRATION TEST *** 

DO YOU WISH TO TEST A LOGIC STATE TRACE MODULE? (Y=YES, 

N=NO) 

If the system being tested includes a trace module, enter Y; otherwise, enter N. and skip 
to step 20. 

5-7 Digital Systems Division 



J Ip^ 946244-9701 



^Xf- 



14. When the user requests testing a trace module, the test displays instructions lorenteringthe 
IINI command to initialize the trace module. Use the applicable one o( the lollowing 
examples: 

1 INT CTRA') TX990 system 

TINT n MOD DX 10 system 

The software responds by displaying a question mark when the initialization is complete. 
The software displays an error message when intialization fails. A typical error that might 
occur during an initialization attempt displays the following message: 

*** ERROR 219 0700 0001 

TRACE MODULE DSR ERROR: 

02XX = ILLEGAL WHILE IRACING, 

06XX = OPERATION ABORTED 

07XX = TRACE MODULE DEVICE ERROR 

If any error message is displayed, verify the connections to the trace module, and verify that 
the trace module is firmly seated in the proper slot. Then repeat the command. 

When the trace module has been successfully initialized, enter the following command to 
resume the test: 

? AMPHDT; 

15. The software begins the first trace module test by displaying the following title: 

-TRACE MODULE INTERNAL CLOCK TEST- 

The test sets up the emulator to execute with no breakpoints or tracing, and sets up the trace 
module to trace using the internal clock, and to halt after tracing 10 items. The test then re- 
executes the program in target memory, and verifies that the trace operation halted the trace 
module. When the status of the trace module indicates that tracing did not stop or that 
something other than completion of the trace operation halted the trace module, the test 
displays the following message: 

*** ERROR: TRACE MODULE FAILED INTERNAL CLOCK TEST 

Recover from the error as described in step 9. 

16. After successfully completing the first trace module test, the software begins the second test 
by dispfaying the foHowing title: 

-TRACE MODULE DATA TRACE TEST- 

The test .sets up the trace module to trace data using external (emulator) clock. I he test also 
sets the trace module to halt the emulator at the completion of the instruction that completes 
the trace operation. The test then re-executes the program in target memory, and verifies 
that the completion of the trace operation halted the emulator and the trace module, and 
that the trace operation correctly traced the data. When the status of the emulator and trace 
modules indicates that the test failed, the test displays the following message: 

*** ERROR: I RACE MODULI FAILED DATA TRACE 

Reco\cr from the ciroi as described m step "J 



5-8 Digital Systems Division 




946244-9701 



1 7. After successfully completing the second trace module test, the software begins the third test 
by displaying the following title: 

-TRACE MODULE EVENT TEST- 

The test sets up the trace module to breakpoint on the first instruction of the program in 
target memory, and re-executes that program. The test then verifies that both the emulator 
and trace modules halted, and that the breakpoint halted the modules. When the status of 
the emulator and trace modules indicates that the breakpoint failed, the test displays the 
following message: 

*** ERROR: TRACE MODULE EVENT FAILURE 

Recover from the error as described in step 9. 

18. After successfully completing the third trace module test, the software begins the fourth test 
by displaying the following title: 

-TRACE MODULE: TRACE DELAY TEST- 

The test uses the same breakpoint set up for the preceding test, but setsupadelayofhahing 
the emulator and trace modules following the breakpoint. The test then re-executes the 
program in target memory, and verifies that the breakpoint executed properly after the 
specified delay. When the status of the emulator and trace modules indicates that the 
breakpoint or delay failed, the test displays the following message: 

*** ERROR: TRACE MODULE DELAY FAILURE 

Recover from the error as described in step 9. 

19. After successfully completing the fourth trace module test, the software displays the 
following message: 

*** TRACE MODULE PASSES HARDWARE DEMONSTRATION TEST *** 

20. The test then displays the concluding message, as follows: 

*** CONCLUSION OF AMPL HARDWARE DEMONSTRATION TEST **♦ 

5.4 RECOVERY PROCEDURE 

The buffer modules contain a switch that connects the clock source for the microprocessor to the clock 
in the emulator or to the clock in the target system. Setting the CLOCK switch to a different position 
during a debugging session requires a recovery procedure to be performed before continuing the test. A 
similar recovery procedure is required when the power to the target system is disconnected and then 
restored. When the TMS 9900 buffer module is in use, observe the following rules: 

• Avoid altering the CLOCK switch setting or interrupting power to the target system while 
the emulator is running. Should this occur inadvertently, restart as described in paragraph 
5.2. 

• After switching clock sources or restoring power with the emulator halted, enter an EINT 
command (paragraph 5.10.1) and restore contents of target system memory. 
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When the TMS 9980 buffer module is in use. recovery is the same as described for the TMS 9900 buffer 
except that a restart is not necessary. An EINT command must be entered to recover in all cases, and 
target system memory contents must be restored. 

5.5 ENTERING COMMANDS 

The user may enter commands and AM PL statements interchangeably. However, when a compound 
statement contains a CLR, RSTR, EDIT, or COPY command, execution of the compound statement 
terminates at completion of the CLR, RSTR, EDIT, or COPY command. Any statement or command 
following any of these commands within a compound statement is not executed. 

Any command or statement may be terminated by a semicolon to promote clarity. There are several 
instances in which semicolons are required to prevent ambiguity. It is good practice to place a 
semicolon following each statement within a CASE statement. This prevents the expression that 
follows from being interpreted as a continuation of the statement. It is also a good practice to place a 
semicolon following each command that has no operands; otherwise an expression within parentheses 
that follows the command is taken as a group of operands and ignored. 

Execution of any command can be terminated and control returned to the AM PL program by pressing 
a key on the system console. When the system console is a 913 VDT, press the HELP key; when the 
console is the 911 VDT, press the CMD key; when the console is the 733 ASR, hold the CNTRL key 
while pressing the X key. 

System variables YR, DAY, HR, MIN.and SEC may be used to add time and date information in the 
listings of AMPL statements, commands and results. These may be displayed but not assigned new 
values. The following example shows the use of these variables: 

J?HR:D2 Hour of the day. Value shown corresponds 

14 to 2 P.M. 

^MIN:D2 Minutes past the hour. 

43 

J|SEC:D2 Seconds past the minute. 

23 

?DAY:D3 Day of the year. Value shown corresponds 

133 to May 13. 

1YR:D4 Year. 

1977 

5.6 PROGRAM COMMANDS 

AMPL software supports two commands to load and save programs in target memory. The LOAD 
command loads a relocatable object module or an absolute module from a diskette file into target 
system memory. Optionally, the command defines load module symbols. The DUMP command stores 
a program from target system memory on a diskette file in absolute format. 

5.6.1 LOAD COMMAND. The LOAD command loads a relocatable module in either standard or 
compressed object format or an absolute module into target system memory. It performs relocation 
functions for relocatable object modules using the bias value specified in the command. The syntax for 
a LOAD command is as follows: 

?LOAD('<access>I,<bias>[, [IDT] [+REF] [4-DEF] ]]) 
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The access name is a character string that contains the name of the module to be loaded. The name of 
the module is a name that is acceptable to the operating system; e.g., a TX990 file name, or a DXIO 
pathname or synonym. The bias is the address in target memory into which the first word of a 
relocatable object module is loaded. When the bias operand is omitted and a relocatable module is to 
be loaded, the default value of AO16 is used. When an absolute module is to be loaded, it is loaded at the 
same locations from which it was stored, and the bias operand is ignored. 

The third operand consists of one or more of the keywords IDT, REF, and DEF (separated by plus 
signs) or the keyword OFF. When the operand is omitted, or when all keywords are entered, the load 
module identifiers, external definitions, and unresolved external references are defined in the symbol 
table as load module symbols. Keyword IDT causes the load module identifier to be defined; keyword 
REF causes unresolved external references to be defined; and keyword DEF causes external 
definitions to be defined. One, two, or all of these keywords may be used, or the keyword OFF may be 
used to load a module without defining any load module symbols. 

ihe user may display the values of any of the three types of load module symbols. The value of an 
unresolved external reference is the target memory address of the end of a linked list of target memory 
locations that require the value of the external reference. Procedure RESOLV (Appendix G) may be 
called to assign a value to these locations, and the external reference may also be assigned that value. 
However, the user must supply the address of the end of the linked list, i.e., the initial value of the 
reference, to procedure RESOLV. The user may not alter the values of external definitions or load 
module identifiers. 

The following are examples of LOAD commands using TX990 file names: 

?LOAD(':MEMOBJ/OBJ\>FE00) Load object file MEMOBJ/OBJ into 

target system memory starting at address 
FEOO16, defining all load module symbols. 



_?LOAD C:MEMABS/ ABS') 



?LOAD (':MYPROG/OBJ', 0100,IDT) 



Load absolute file MEM ABS/ ABS into 
target system memory at address supplied 
in the file. 

Load an object file having a synonym of 
FILEl MYPROG/OBJ into target 
system memory starting at address IOO16, 
defining load module identifiers only. 



The following are examples of LOAD commands using DXIO pathnames and synonyms: 

2LOAD('VAMPL.OBJ.MEMOBJ',>FE00) Load object file VAMPL.OBJ.MEMOBJ 

into target system memory starting at 
address FEOO16, defining all load module 
symbols. 



? LOAD ('VAMPL.ABS.MEMABS') 



? LOAD ('FILEr,0100,IDT) 



Load absolute file VAMPL.ABS. 
MEM ABS into target system memory at 
address supplied in the file. 

Load an ojbect file having the synonym 
FILEl into target system memory starting 
at address IOO16, defining load module 
identifiers only. 
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The LOAD command does not support image files or segmentation tags. If the object code contains a 
tag other than through F or I, an error occurs when the loader attempts to process the tag. The object 
module may be link edited by either SDSLINK or TXSLNK to obtain a module that may be loaded by 
the LOAD command. However, no load module symbols are defined unless the SYMT option is used 
both in assembly and link editing, and then only the module identifier is defined. 

5.6.2 DUMP COMMAND. The DU M P command stores a program on a specified file from specified 
locations m target system memory. Optionally, the command also stores a specified entry point The 
syntax for a DUMP command is as follows: 

?DUMP ('<access name>',<start>,<end>[,<entry>]) 

The access name is a character string that contains the name of the file on which the program is to be 
stored. The name of the file is a name that is acceptable to the operating system; e.g., a TX990 file name, 
or a pXlO pathname or synonym. When the files does not exist, AM PL software creates a file. When 
the tile contains data, the program replaces the previous contents of the file. The start operand is the 
address of the first word to be stored, and the end operand is the address of the last word to be stored. 
The entry operand is the address of the entry point of the stored program. 

The DUMP command stores a program in absolute format. When the entry operand is specified, the 
value is placed in the program counter of the emulator when the program is loaded. Files written by the 
DUMP command may be reloaded by the LOAD command which restores the program in target 
memory for further testing and debugging. 

The following is an example of a DUMP command using a TX990 pathname: 

? DUMP (':MEMABS/ABS',>FE00,>FE46,>FE26) Store target memory contents 

beginning at address FEOOie 
and ending at address FE46i6 
on file MEMABS/ABS, and 
store FE26i6 as the entry point 
for the program. 

The following is an example of a DUMP command using a DXIO pathname: 

? DUMP('VAMPL.ABS.MEMABS',>FE00,>FE46,>FE26) scores target memory 

contents beginning at ad- 
dress FE00,6 and end- 
ing at address FE46i6 
on file VAMPL.ABS. 
MEMABS, and store 
FE26i6 as the entry point 

5.7 UTILITY COMMANDS for the program. 

AM PL software supports the following utility commands: 

• Define Console (CNSL) 

• Define Listing Device (LIST) 

• Multiply (MPY) 

• Divide (DIV) 
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Display Register Contents (DR) 

Display User Symbol Table (USYM) 

Display Load Module Symbol Table (MSYM) 

Delete Load Module Symbol Table (MDEL) 

Display System Symbol Table (SSYM) 

Save Test Environment (SAVE) 

Clear Test Environment (CLR) 

Restore Test Environment (RSTR) 

Enter Text Editor (EDIT) 

Copy Input (COPY) 

Delete Procedure (DELE) 

Delay AMPL Execution (WAIT) 

Output New Line (NL) 

Verify (VRFY) 

Terminate AMPL Program (EXIT) 

5.7.1 DEFINE CONSOLE COMMAND. The Define Console command (CNSL) defines an 
alternate device to replace the device currently being used as system console, or switches the output to 
the console on and off. The syntax for the CNSL command is as follows: 

|'<device name>' 
OFF 
ON 

The device name is a character string that contains the device name (as defined for the operating 
system) of a console device to replace the current system console. The keyword OFF causes output to 
the system console to be disabled. The keyword ON causes output to the system console to be 
reenabled following entry of a CNSL command with the OFF keyword. When a CNSL command is 
entered with a device name operand, the named device displays the question mark requesting a new 
command at the completion of this command. When a CNSL command is entered with the keyword 
ON the previously defined system console displays the question mark at the completion of this 
comand. The following are examples of CNSL commands: 



?CNSL('ASR') 



? CNSLrSr07') 



The 733 ASR replaces the system console 
(TX990). 

The terminal ST07 replaces the system- 
assigned console terminal (DXIO). 



Execution of a CNSL command in a DXIO system does not affect the synonyms assigned to the AMPL 
terminal. The synonyms defined at the terminal from which AMPL was called continue to apply. 
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5.7.2 DEFINE LISTING DEVICE COMMAND. The Define Listing Device command (LIST) 
defines a supplementary listing device or file, or stops or starts supplementary listing. While listing is 
on, all data displayed on the system console is also displayed on the listing device or written to the 
listing file. The following is the syntax for the LIST command: 



?LIST( 



'<access name>' 
OFF 

ON 



) 



The operand is a character string that contains a pathname or either of the reserved words OFF or ON. 
A TX990 pathname may be that of a device or file; a DXIO pathname may be a device name, a file 
pathname, or a synonym. The pathname is that of a device or file to display or store the supplementary 
listing. When the pathname is that of a file that does not exist, AM PL software creates the file. When 
the file already contains data, the data in the file is replaced by the new data. When OFF is entered, 
supplementary output is terminated. Reserved word ON is only valid when reserved word OFF has 
been entered in a previous LIST command, and restores supplementary output to the device or file that 
was previously defined for supplementary output. A LIST command with a new pathname may be 
entered at any time; the device or file previously defined is closed and the newly defined device or file is 
opened and output begins. 

The following is an example of a series of LIST commands using TX990 pathnames: 



?LIST(':OFILE/LST') 
?LIST('LP') 

^LIST(':OFILE/LST') 

2LIST(0FF) 
?LIST(ON) 



Write supplementary output on file 
DSCOFILE/LST. 

Print supplementary output on Line 
Printer instead of writing to 
DSC:OFILE/LST. 

Write supplementary output on file 
DSC:OFILE/LST replacing previously 
written output. Terminate output to Line 
Printer. 

Terminate supplementary output, 
displaying output on system console only. 

Resume supplementary output, adding it 
to file DSCOFILE/LST, following 
previously written output. 

The following is an example of a series of LIST commands using DXIO pathnames: 



7LISTCVAMPL.LST.OFILE') 



^LIST('LPOr) 



JLIST('VAMPL.LST.OFILE') 



Write supplementary output on file 
VAMPL.LST.OFILE. 

Print supplementary output on Line 
Printer instead of writing to 
VAMPL.LST.OFILE. 

Write supplementary output on file 
VAMPL.LST.OFILE replacing 
previously written output. Terminate 
output to Line Printer. 
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?LlST(OFF) Terminate supplementary output, 

displaying output on system console only. 

?LIST(ON) Resume supplementary output, adding it 

to file VAMPL.LST.OFILE following 
previously written output. 

5.7.3 MULTIPLY COMMAND. The Multiply command ( M PY) is a system function that multiplies 
two 16-bit unsigned numbers and returns the least significant 16 bits of the product. The most 
significant 16 bits of the product are stored in system variable MDR. The syntax of the MPY command 
is as follows: 

?MPY(<multiplicand>,<multiplier>) 

The operands are expressions, the 16-bit values of which are multipled as unsigned numbers. The 
following is an example of an MPY command: 

? MPY (24,10) .. , . , -. . .. 

MPY ~= >0(ZIFQ Multiply 24 times 10. 

? |V|[)f( Obtain the most significant half of the 
MDR ~= >O0(3ffl product. The complete product is 
000000 FO, 6, or 240. 

Alternatively, the command and its operands may be used as an expression in an AM PL statement. 
The value ofthe expression is the 16 low-order bits of the product. Variable MDR contains the 16high- 
order bits of the product. The following is an example of an AMPL statement that contains an MPY 
command: 

?REPEATJiN = N + IfiUNTILIiMPY (CNT,N)kiGT|zS10i3i3 Increment N by 1 until the least 

significant half of the product is 
greater than 1000. Unless the pro- 
duct of the initial value of CNT 
times N + 1 is greater than 65,535 
MDR contains zero. 

5.7.4 DIVIDE COMMAND. The Divide command (DIV) is a system function that divides a 32-bit 
unsigned number by a 1 6-bit unsigned number, and returns the 1 6-bit quotient. The most significant 1 6 
bits of the dividend must be placed in system variable MDR prior to executing the command. The 
remainder is in MDR following the operation. The syntax of the DIV command is as follows: 

?DIV«divisor>,<dividend>) 

The operands are expressions. The 16-bit value ofthe dividend operand is combined with the value of 
MDR and is divided by the 16-bit value of the divisor operand. The following is an example of an 
assign statement that places the high-order portion ofthe dividend in MDR, and a DIV command: 

f DIV ^59^ ^'^^'^^ '^^^^" ^^^'^^^^ ^^ ^^' 

DIV ~= >0456 

? MDR 
,,-,-, — 2^„r. Display remainder. 

MDR = >g)02E 

Alternatively, the command and its operands may be used as an expression in an AMPL statement. 
The value of the expression is the quotient, and variable MDR contains the remainder. The following 
is an example of an AMPL statement that contains DIV command: 
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I DISP = DEST - PC + 2 
? MDR = 

7_ DISP - DIV(2,DISP) 



IF0MDRt5NE|i5OtliTHENt5'ERROR' 



Initialize DISP. 

Set MDR to most significant half of 

dividend. 

Compute displacement for jump to DEST 

when DEST is greater than contents of 

PC. 

Display ERROR if DEST has an odd 

value. 



5.7.5 DISPLAY REGISTER COMMAND. The Display Register command (DR) displays the 
contents of the target system program counter, workspace pointer, and status register, the contents of 
the address in the program counter, and the contents of workspace registers through 1 5 of the current 
target system workspace. The contents are displayed in hexadecimal format and the contents of the 
address in the program counter are also displayed in instruction format. The syntax for the command 
is as follows: 



?DR; 



The following is an example of the DR command showing the resulting display: 



M. 
Rl 



R2_ 
R3 



? DR; 
~= >(?03Q 
= >0F98 



R8 = > 



R9 



PC = >012E / >06g1 DEC Rl 



>mm WP = >(3134 



= >FFFF R10 



ST = > 



= >FFFF Rll = >g1glE 



R4 


= >FFFF R12 = 


>1FE(2 


R5 


= >FFFF R13 = 


>(?0(J0 


R6 


= >mn R14 = 


X2I000 


R7 


= >mm R15 = 


>mH 



5.7.6 DISPLAY USER SYMBOL TABLE COMMAND. The Display User Symbol Table command 
(USYM) displays a list of all user symbols, the symbol types, and the symbol values. The display 
includes a count of the symbols also. The syntax for the command is as follows: 

2USYM; 

The AM PL software prints one of the following symbol types after each symbol: 



VAR 
PROC 
FUNC 
ARRAY 



Variable 
Procedure name 
Function name 
Array name 



The software prints the symbol value after the symbol type. For a variable, the value is the value of the 
variable. For a procedure name, a function name, or an array name, the value is the host memory 
address of the procedure, function, or array, respectively. 
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5.7.7 DISPLAY LOAD MODULE SYMBOL TABLE COMMAND. The Display Load Module 
Symbol Table command (MSYM) displays a list of all load module symbols, the symbol types, and 
the symbol values. The display includes a count of the symbols also. The syntax for the command 
is as follows: 

?MYSM; 

The AMPL software prints one of the following symbol types after each symbol: 

IDT Module identifier 

DEP External definition 

REF Unresolved external reference 

The software prints the symbol value after the symbol type. For the module identifier, the value 
is the target system memory address into which the module was loaded. For an external definition, 
the value is the target system memory address corresponding to the defined symbol. For an un- 
resolved external reference, the value is either the most-recently assigned value, or the initial 
value, if no value has been assigned. The initial value is the target system memory address of the 
last location of a linked hst of addresses into which the reference should be loaded. 

The following is an example of the MSYM command showing the resulting display: 

?MSYM; 

MAIN IDT >0100 

START DEF >0120 

BUFF DEF >0430 

5.7.8 DELETE LOAD MODULE SYMBOL TABLE COMMAND. The Delete Load Module 
Symbol Table command (MDEL) deletes all load module symbols in the load module symbol table. 
The syntax for the command is as follows: 

?MDEL; 

It is possible to load a module without deleting the load module symbols of a previously loaded module 
by using the OFF option in the LOAD command. The user may clear the load module symbol table 
without clearing the other symbol tables by entering this command. 

The following is an example of the MDEL command followed by an MSYM command: 

2MDEL; 
?MSYM; 
ENTRIES IN TABLE 

5.7.9 DISPLAY SYSTEM SYMBOL TABLE COMMAND. The Display System Symbol Table 
command (SSYM) displays a list of system symbols, the symbol types, and the symbol values. The 
display includes a count of the symbols, also. The syntax for the command is as follows: 

?SSYM; 
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The AMPL software prints one of the following symbol types after each symbol: 

VAR Variable 

PROC Procedure name 

FUNC Function name 

ARRAY Array name 

The software prints the symbol value after the symbol type. For a variable, the value is the value of the 
variable. For a procedure name, a function name, or an array name, the value is the host memory 
address of the procedure, function, or array, respectively. 

5.7.10 SAVE TEST ENVIRONMENT COMMAND. The Save Test Environment command 
(SAVE) stores the test environment and a program from specified locations in target system memory 
on a specified file. The test environment includes a user symbol table, and user procedures and 
functions. Optionally, the command also stores the specified entry point. The syntax for the SAVE 
command is as follows: 

?SAVE('<access name>'[,<start>,<end>[,<entry>] ] ) 

The access name is a character string that contains the name of the file on which the test environment 
and program are to be stored. The name of the file is a name that is acceptable to the operating system; 
e.g., a TX990 file name, or a DXIO pathname or synonym. When the file does not exist, AMPL 
software creates the file. When the file contains data, the test environment and program replaces the 
previous contents of the file. The start operand is the address of the first word to be stored, and the end 
operand is the address of the last word to be stored. The entry operand is the address of the entry 
point of the stored program. When the start and end operands are omitted, the program is not 
saved; only the test environment is saved. When the entry operand is omitted, the RSTR command 
does not alter the contents of the program counter. The file written by the SAVE command may 
be read by the RSTR command to restore a test environment and a target system program to 
resume a test. 

The test environment stored by a SAVE command consists of currently defined user symbols, current 
default format specifications, user procedures, and user functions. No device assignments or device 
status are stored. The following is an example of a SAVE command using a TX990 file name: 

?SAVE {' :MYDBUG/SAV' ,>FE(2)(J,>FE46,>FE26) Store test environment on file 

DSC:MYDBUG/SAV. Also store the 
contents of target memory starting at 
address FEOOu and ending at address 
FE46i6 and store FE26i6 as the entry 
point. 

The following is an example of a SAVE command using a DXIO file name: 

ISAVE ('VAMPL,SAV,MYDBUG,>FE00,>FE46,>FE26) Store test environment 

on file VAMPL.SAV. 
MYBUG. Also store the 
contents of target memory 
starting at address FEOOi^ 
and ending at address 
FE46i6, and store FE26,6 
as the entry point. 
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5.7.11 CLEAR TEST ENVIRONMENT COMMAND. The Clear Test Environment command 
(CLR) clears the test environment, and optionally reserves space for a user symbol table for a specified 
number of symbols. The syntax for the CLR command is as follows: 

?CLR [«symbols»] 

The CLR command deletes all user symbols, user procedures, and user functions. The optional 
symbols operand is an expression having a positive integer value (greater than zero) which is the 
number of user symbols that may be defined in the user symbol table. A CLR command allows 
redefining a test environment. Following a SAVE command, a CLR command prepares the working 
storage for the start of another test. The user may change the size of the user symbol table with the 
optional operand. Unless a previous CLR command has changed the symbol table, the capacity of the 
user symbol table is 30 symbols. The user may reduce the size to provide more memory space for 
procedures and functions if few symbols are required. The user may increase the size to allow more 
symbols to be defined. In deciding how large the table should be, the user should notice that LOAD 
commands define module names as user symbols, PROC and FUNC statements define procedure and 
function names that are placed in the table, and assign statements define user symbols unless the 
symbol has previously been defined. 

When a CLR command is entered in a compound statement, and the statement executed, completion 
of execution of the CLR command terminates the compound statement. Any statements within the 
compound statement following the CLR statement are not executed. 

The following is an example of a CLR command: 

?CLR (19) Clear the user symbol table, and delete 

any user procedures and functions. 
Provide a user symbol table having a 
capacity of 19 user symbols. 

5.7.12 RESTORE TEST ENVIRONMENT COMMAND. The Restore Test Environment command 
(RSTR) restores the test environment in the host computer memory and a program in target system 
memory. The test environment and program are obtained from a file written by a SAVE command. 
When the SAVE command included an entry point operand, the RSTR command places the entry 
point in the target system program counter. The following is the syntax for the RSTR command: 

?RSTR('<access name>') 

The access name is a character string that contains a TX990 file name, or a DXIO pathname or 
synonym. When the RSTR command completes, the user symbol table, user procedures, and user 
functions are in the host computer memory in the state stored by the SAVE command, and the 
program defined in the SAVE command has been loaded into target system memory. Device 
assignments made in CNSL, LIST, or COPY commands prior to the RSTR command remain in 
effect. 

When an RSTR command is entered in a compound statement and the statement is executed, 
completion of execution of the RSTR command terminates the compound statement. Any statements 
within the compound statement following the RSTR command are not executed. 
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It is possible lor there to be more than one TX990 operating system in which the AM PL program 
executes; systems in which the program occupies different locations in memory. The SAVE and RSTR 
commands use absolute memory addresses. An RSTR command will not correctly restore the test 
environment when the SAVE command is executed by the AMPL program in different areas of 
memory. 

In a DXIO system, memory mapping allows the system to place the AMPL program anywhere in 
memory, and the restriction of the SAVE and RSTR commands to the same system environment 
does not apply. However, the memory size parameter (paragraph 5.2.2) in effect when the RSTR 
command is executed must be large enough to accommodate the data stored by the SAVE 
command. 

The following is am example of a RSTR command using a TX990 file name: 

''RSTR ( ' -MYDBUG/SAV ) Restore lab test environment and program 

at point at which file DSC: MYDBUG/SAV 
was written. 

The following is an example of an RSTR command using a DXIO pathname: 

_?RSTR (VAMPL.SAV.MYDBUG) Restore lab test environment and 

program at point at which file 
VAMPL.SAV.MYDBUG was written. 

5.7.13 ENTER TEXT EDITOR COMMAND. The Enter Text Editor command (EDIT) saves the 
test environment and terminates the AMPL program. The command also activates the Text Editor, 
and returns control to the AMPL program at the end of the editing operation. Then the command 
restores the stored test environment and resumes the test. The command is supported only in a TX990 
system. The following is the syntax for the EDIT command: 

?ED1T [('<access name>')] 

The access name is a character string that contains the name of a file. The operand is a TX990 file name 
of the file to be edited. When the access name is omitted, the file name is DSC:AMPL000/ PRC. 

The command stores the test environment on file DSC:AMPLOOO/SAV and transfers control to the 
program in a file named DSC:TXEDIT/ SYS or DSC2:TXEDIT/SYS (on floppy disk unit I or 2, 
respectively). The parameters passed to TXEDIT are the file name (the operand of the command) or 
DSC: AM PLOOO/ PRC as the file to be edited, file DSC: AM PLOOO/ SCR as the scratch file, and M9000 
as the memory size parameter. This allows about 150 lines ofcode in the editor's buffer. When editing is 
terminated, the data entered is in the scratch file. TXEDIT displays the message: 

TEXT IN SCRATCH FILE 
TRANSFER TO INPUT? 

The user should enter a Y for yes to transfer the data to the file named in the EDIT command or to file 
DSC:AM PLOOO/ PRC. If the user enters N for no, the data may only be accessed on file 
DSC:AM PLOOO/ SCR, where it will be replaced during the next editing performed with an EDIT 
command. Control transfers to the program in file DSC:AMPL/SYS (on the left hand floppy disk 
unit), and the environment is restored from file DSC:AMPLOOO/SAV. 

If the transfer to TXEDIT or back is unsuccessful, the system displays the following message: 

BATCH ABORTED 
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The user may reactivate AM PL and enter a RSTR command that specifies file DSC: AM PLOOO/SAV 
to recover from the error. 



The following are examples of EDIT commands: 
? EDIT; 



2 EDIT CDSC2:MYPROJ/PRC') 



Edit file DSC: AMPLOOO/ PRC. Invalid in 
a DXIO system. 

Edit file DSC2:MYPROJ/PRC. Invalid 
in a DXIO system. 



5.7.14 COPY INPUT COMMAND. The Copy Input command (COPY) changes the input source to 
a specified file or device. The AM PL software reads commands and statements from the specified file 
or device until it reads an end-of-file, then resumes input from the system console. The syntax for the 
COPY command is as follows: 

?COPY [('<access name>')] 

The access name is a character string that contains the name of a file or device. The name of the file or 
device is a namethat is acceptable to the operating system; e.g., a TX990 file or device name, or a DXIO 
device name or file pathname or synonym. When the operand is omitted in a TX990 system, the COPY 
command copies the most recently edited file (edited by the Text Editor during execution of an EDIT 
command). When an EDIT command has not been executed since the AM PL program was activated, 
an error message is issued. The operand is required in a DXIO system. 

When commands and statements are read as specified in a COPY command, they are not displayed on 
the system console. When a LIST command is in effect, they are written to the list device or file. 

A copy file may contain a COPY command that transfers the input to another device or file. This 
provides chaining, rather than nesting; reading of statements from a file continues until either another 
COPY statement or an end-of-file is read. When an end-of-file is read, the system console resumes 
input. Any statements or commands that follow a COPY command on a copy file or in a compound 
statement are not executed. There is no limit to the number of copy files that may be chained in this 
way. 

The following is an example of a COPY command using a TX990 file name: 



?COPY (':AMPLFN/CPY') 



Execute the commands and statements 
on file DSC:AMPLFN/CPY and return 
input to the system console at end-of-file. 



The following is an example of a COPY command using a DXIO pathname: 



?COPY CVAMPL.CPY.AMPLFN') 



Execute the commands and statements on 
file VAMPL.CPY.AMPLFN and return 
input to the AM PL terminal at end-of- 
file. 



5.7.15 DELETE COMMAND. The Delete command (DELE) deletes the specified user procedure, 
function, or array from host memory. The syntax for the DELE command is as follows: 

?DELEC<name>',['<name>']. . . ) 
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The operands are character strings that contain the names of user procedures, (unctions, or arrays to be 
deleted. Deleting a procedure, function, or array makes its memory space available for redefinition of 
the same procedure, function, or array, or for other purposes. 

Executing a DELE command does not delete the name in the user symbol table. The name of a deleted 
procedure may only be used in a PROC statement as a procedure name, and the name of a deleted 
function may only be used in a FUNC statement as a function name. The name of a deleted array may 
only be used inanARRAY statement as the name of an array with the same number of dimensions. To 
make these names available for other purposes, the user must execute a CLR command to clear the 
symbol table. 

The following is an example of a DELE command: 

2DELE ('TIMEN', 'MEMTST, 'NUM') Delete procedure TIMEN, function 

MEMTST, and array NUM. 

5.7.16 DELAY AMPL EXECUTION COMMAND. The Delay AM PL Execution command 
(WAIT) delays execution of AMPL software for a specified number of 50 ms periods. The syntax of 
the WAIT command is as follows: 

2WAlT«number>) 

The operand is an expression that specifies the number of 50 ms periods of delay. During the delay 
period, execution of AMPL software is suspended. At the end of the delay period the AMPL software 
resumes execution and displays a question mark to request another command or statement. An 
operand of 20 provides a delay of one second. The WAIT command is useful when displaying data on 
the screen of a VDT. When displaying data continuously the data may not remain on the screen long 
enough to be read by the user. The user may place a WAIT command following each display statement 
to provide enough lime to read the display. The WAIT command is not affected by pressing the key 
that terminates execution of other commands as described in paragraph 5.3. 

The following is an example of a WAIT command: 

1 WAIT(200) Delay 10 seconds. 

? . . TEN SECONDS LATER 

5.7.17 OUTPUT NEW LINE COMMAND. The Output New Line command (NL) outputs a carriage 
return and line feed to the system console and supplementary listing device, when a supplementary 
listing device is active. The following is the syntax for the NL command: 

?NL; 

No operand is required. The NL command is intended for use in a procedure, function, or compound 
statement. It is equivalent to a display statement using the N format specification and displaying 
spaces. The following is an example of an NL command: 

? NL; 

5.7.18 VERIFY COMMAND. The Verify command (VRFY) verifies a program in target system 
memory by comparing the contents of the specified file with the contents of memory starting at the 
specified bias address. The software prints the contents of the addresses that do not contain the values 
in the file. The syntax for a VRFY command is as follows: 

?VRFY('<access name>[,<bias>]) 
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The access name is a character string that contains a TX990 file name, or a DXIO pathname or 
synonym. The bias operand is the address in memory at which the program to be verified was loaded. 
When the specified file contains an absolute program, the software ignores the bias operand. When the 
file contains a relocatable program and the bias operand is omitted, the default value of A0i6 is used. 

The VRFY command prints the address, file contents, and memory contents of every address that 
contains data different from that in the file. The command may be used to verify the loading of a 
program, or to identify locations within a program that have been altered from the values loaded. Data 
areas that are reserved by the program using directives such as BSS and BSE cannot be verified with 
the VRFY command. When the contents of every address agree with the contents of the file, no 
message is printed. 

The following is an example of a VRFY command using a TX990 file name and the messages that 
identify locations that have been ahered: 

1VRFY( 'DSC:SINTST/OBJ' ,>1000) Verify contents of locations loaded from 

>0114 / >mm >0eiglE file DSC:SINTST/OBJ at location 1000,6. 



>015A / 


>0000 


>3CI20 


>015C / 


>0000 


>6ED8 


>015E / 


>0000 


>4004 



The following is an example of a VRFY command using a DXIO pathname: 

I VRFY( 'VAMPL.OBJ.SINTST' ) Verify contents of locations loaded from 

file VAMPL.OBJ.SINTST at location 
IOO16. Absence of a message indicates that 
no location was altered. 

5.7.19 TERMINATE AMPL PROGRAM COMMAND. The Terminate AMPL Program 
command (EXIT) terminates the program and returns control to the operating system. The syntax for 
the EXIT command is as follows: 

?EXIT ('<access name>' ,<start>,<end> ,<entry> ) 

The operands apply only to DXIO; if they are entered for TX990, they are ignored. The access name is a 
character string that contains the pathname of synonym of a file on which the test environment and 
program are to be stored. When the file does not exist, AMPL software creates the file. When the file 
contains data, the test environment and program replaces the previous contents of the file. The start 
operand is the address of the first word of target system memory to be stored, and the end operand is 
the address of the last word to be stored. The entry operand is the address of the entry point of the 
stored program. When the EXIT command is entered without operands, the AMPL program 
terminates. When the operands are included (in a DXIO system), the program performs a SAVE 
command, assigns the access name operand as the value of synonym $AMPL$E, and terminates. 
Refer to paragraph 5.7.10 for the effect of omitting the start and end operands or the entry 
operand. The use of a synonym allows the AMPL SCI command (which activates the AMPL 
program) to obtain the pathname of the save file and restore the environment and program when 
the AMPL program is next activated. Use of synonym $AMPL$E for any other purpose, assigning 
another value to it, or deteting it will prevent proper restoration of the test environment when the 
AMPL program is next activated. 
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To resume execution of the AM PL program before loading another program into host memory (when 
executing under TX990), it is not necessary to load the program again. The following is an example of 
an EXIT command followed by the entry that restarts the program: 

?EXIT; Terminate the AMPL program. 

PROGRAM: >10* Restart the AMPL program. 

When another program has been loaded into host system memory, the AMPL Program must be 
restarted as follows (under TX990): 

PROGRAM: :AMPL/SYS* 

When executing under DXIO, perform the procedure in paragraph 5.2.2 beginning at step 20 to 
restart the AMPL program. When the EXIT command specified a save file, a start address, and 
an end address, the test environment and program are restored as the AMPL program begins 
execution. If synonym $AMPL$E has been altered, the results are unpredictable. 

The following is an example of an EXIT command with operands supported by DXIO: 

lEXIT ('VAMPL.SAV.MYDBUG',>FE00,>FE46,>FE26) Terminate the AMPL pro- 

gram, storing the test 
environment on file 
VAMPL.SAV.MYDBUG. 
Also store the contents of 
target memory at address 
FEOO16 and ending at ad- 
dress FE46i6, and store 
FE26i6 as the entry point. 

The capability of storing the test environment with an EXIT command provides a capability under 
DXIO similar to that of the EDIT command under TX990. After the execution of the EXIT command, 
the user may activate the Text Editor to write or edit a file. When the user restarts the AMPL program, 
the program resumes at the point at which the EXIT command was executed. 

5.8 CRU COMMANDS 

AMPL software supports two sets of CRU commands. One set, CRUR and CRUW, reads from and 
writes to a CR U device of the target system. System variable CRUB contains the CRU base address for 
the read and write operations. The other set, HCRR and HCRW, reads from and writes to a CRU 
device of the host system. System variable HCRB contains the CRU base address for the read and 
write operations for the host system. 

The user may check out any device on the CRU interface of the target system using CRUR and 
CRUW. When the target system is a controller or similar device that interfaces with a Model 990 
Computer via the CRU interface, it can be connected to the host system, and HCRR and HCRW can 
be used to verify the CRU interface. 

5.8.1 CRU READ COMMAND. The CRU Read command (CRUR) is a system function that reads a 
specified number of bits from a specified address in the target system CRU. System variable CRUB 
contains the CRU base address and the command returnsthe value right-justified in a 16-bit word. The 
syntax for the command is as follows: 

?CR U R(<displacement>,<length>) 
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The displacement operand is an expression, the value of which represents a number of CRU lines 
(either positive or negative) by which the most significant bit read is displaced from the base address in 
system variable CR U B. The length operand is an expression having a positive integer value in the range 
of 1 through 16, which represents the number of bits to be read. 

The software multiplies the value of the displacement operand by two and adds the product to the base 
address algebraically. The software then reads the number of bits specified by the length operand, and 
returns the value right-justified in a 16-bit word. 

The following is an example of assigning a base address value and a CRUR command: 

?CRUB = >0100 



?CRUR(8,8) 



Assign value of lOOu as CRU base 
address. 

Read 8 bits from target system CRU at 
address derived from base address of IOO15 
plus IO16 (CRU address 8815). 



Alternatively, the command and its operands may be used as an expression in an AM PL statement. 
The value of the expression is the data read from the target system CRU. The following is an example 
of a CRUR command used in this way, assuming that CRUB remains unaltered from the preceding 
example: 



?CRUOUT = CRUR (0,8) 



Read 8 bits from target system CRU and 
assign the value to user symbol CROUT. 
The CRU address is derived from CRU 
base address IOO16 (CRU address 8O16). 



5.8.2 CRU WRITE COMMAND. The CRU Write command (CRU W) writes a specified value into a 
specified number of bits of the target system CRU at a specified address. System variable CRUB 
contains the CRU base address. The following is the syntax for the command: 

?CRUW(<displacement>,<length>,<value>) 

The displacement operand is an expression, the value of which represents a number of CRU lines 
(either positive or negative) by which the most significant bit written is displaced from the base address 
in system variable CRUB. The length operand is an expression having a positive integer value in the 
range of 1 through 16, which represents the number of bits to be written. The value operand is an 
expression, the value of which is written. 

The software multiplies the value of the displacement operand by two and adds the product to the base 
address algebraically. The software then writes the number of bits specified by the value of the length 
operand. The rightmost bits of the value operand are written to the CRU. The following is an example 
of the CRU W command, which assumes that CRUB remains unaltered from the preceding example: 



?CRUW (16,4,>A) 



Write the value IOIO2 into the target 
system CRU at address derived from base 
address of IOO16 plus 20i6 (CRU address 
90,6). 



5.8.3 HOST CRU READ COMMAND. The Host CRU Read command (HCRR) is a system 
function that reads a specified number of bits from a specified address in the host system CRU. System 
variable HCRB contains the CRU base address and the command returns the value right-justified in a 
16-bit word. The syntax for the command is as follows: 

?HCRR{<displacement>.<length» 
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The displacement operand is an expression, the value of which represents a number of CRU lines 
(either positive or negative) by which the most significant bit read is displaced from the base address in 
system variable HCRB. The length operand is an expression having a positive integer value in the 
range of I through 16, which represents the number of bits to be read. 

The software multiplies the value of the displacement operand by two and adds the product to the base 
address algebraically. The software then reads the number of bits specified by the length operand, and 
returns the value right-justified in a 16-bit word. 

The following is an example of assigning a base value and an HCRR command: 



?HCRB = >0200 



Assign value of 200i6 as CRU base 
address. 



?HCRR(0,8) 



Read 8 bits from host system CRU at 
address derived from base address of 200i6 
plus (CRU address 100,6). 



Alternatively, the command and its operands may be used as an expression in an AM PL statement. 
The value of the expression is the data read from the host system CRU. The following is an example of 
an HCRR command used in this way, assuming that HCRB remains unaltered from the preceding 
example: 

WUCHAR = HCRR(16,8) Read 8 bits from target system CRU and 

assign the value to user symbol 
NUCHAR. The CRU address is derived 
from the base address of 200i6 plus 20i6 
(CRU address 11 Oie). 

5.8.4 HOST CRU WRITE COMMAND. The Host CRU Write command (HCRW) writes a 
specified value into a specified number of bits of the host system CRU at a specified address. System 
variable HCRB contains the CRU base address. The following is the syntax for the command: 

?HCRW(<displacement>,<length>,<value>) 

The displacement operand is an expression, the value of which represents a number of CRU lines 
(either positive or negative) by which the most significant bit written is displaced from the base address 
in system variable HCRB. The length operand is an expression having a positive integer value in the 
range of 1 through 16, which represents the number of bits to be written. The value operand is an 
expression, the value of which is written. 

The software multiplies the value of the displacement operand by two and adds the product to the base 
address algebraically. The software then writes the number of bits specified by the value of the length 
operand. The rightmost bits of the value operand are written to the CRU. The following is an example 
of the CRU W command, which assumes that HCRB remains unaltered from the preceding example: 



?HCRW (8,8,"BC") 



Write the ASCII representation of C into 
the host system CRU at the address 
derived from base address of 200i5 plus 
10,5 (CRU address 108,6). 
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CAUTION 

Use extreme care that the CRU base address in HCRB is correct before 
executing an HCRW command. If an HCRW command is executed 
with a value in HCRB that causes the command to address one or more 
lines to the host system peripheral devices, normal operation of the 
system is impaired. 

5.9 DATA INPUT COMMANDS 

The AM PL software supports reading a file of data into host or target memory. The file may be 
prepared using the Text Editor, and must contain valid AM PL expressions separated by spaces. The 
expressions in the file may contain variables and/or constants separated by arithmetic operators + and 
- only. The Data Input commands are OPEN, READ, and CLSE. Another command, EOF, also 
applies to read operations. 

5.9.1 OPEN COMMAND. The OPEN command specifies the device to be used for data input. The 
syntax for the OPEN command is as follows: 

?OPEN('<access name>') 

The operand is a character string that contains a pathname (as defined for the operating system) of a 
data file or a device name of a data input device. An OPEN command must be executed prior to 
leading data from a file or device other than the AMPL terminal or if reading is to be resumed from a 
file or device other than the AMPL terminal after a Close operation. 

The following are examples of OPEN commands using TX990 file and device names: 

? OPEN(':INPUT/ DAT') Open file :INPUT/ DAT for data input. 

7 0PENCASR') Open 733 ASR terminal (not system 

console) for data input. System console 
does not require entry of an OPEN 
command. 

The following are examples of OPEN commands using DXIO pathnames and device names: 

? OPENCVAMPL.DAT.INPUT') Open file VAMPL.DAT.INPUT for data 

input. 

? OPEN('ST09') Open terminal other than AMPL terminal 

for data input. AMPL terminal does not 
require entry of an OPEN command. 

5.9.2 READ COMMAND. The READ command is a system function that returns the value of the 
next expression from the data input file or device specified in the current OPEN command, or from the 
AMPL terminal if an OPEN command is not in effect. The syntax for the READ command is as 
follows: 

? READ; 
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The READ command may be entered as an AMPL statement to display the value of an expression 
read from a file or device. Each record may contain only one expression. The typical use of the 
command is in an assign statement, to assign the value of the expression to a variable or to a target 
system location. The following are examples of assign statements using READ commands: 

j'DATIN = READ; Assign the next constant in the file to 

DATIN. 

^@(START+48) = READ; Assign the next constant in the file to 

target system memory location START 

+48. 

When a READ command is executed with no OPEN command in effect (either no OPEN command 
has been entered or a CLSE command has been entered since the most recent OPEN command), the 
software requests the user to enter an expression as follows: 



The user enters an expression followed by a carriage return. The expression must be either a constant, a 
variable, or a series of constants and/ or variables connected by arithmetic operator + or -. Other 
operators are invalid and result in an error message. Spaces may be entered as desired. The following 
are examples of expressions that may be entered: 

^>23C0 The value of the expression is 23C0i6. 

=? MYVAR + OAO The value of the expression is the sum of 

the value of variable MYVAR plus AO16. 

— ? MYVAR - 4 The value of the expression is the 

difference of the value of variable 
MYVAR minus 4. 

When an OPEN command specifiesa terminal and a READ command is entered, the AMPL program 
does not display an equal sign and a question mark as in the preceding examples. The user may enter 
expressions in the same manner as if the prompt had been displayed. 

5.9.3 EOF COMMAND. The EOF command is a system function that returns the state of the end-of- 
file flag for the file or device. The syntax for the command is as follows: 

?EOF; 

The EOF command performs a read operation to obtain the current state of the flag, and returns a 
nonzero value (true) when end-of-file has been set, or a zero value (false) when end-of-file has not been 
set. A subsequent READ command returns the data read in the read operation performed by an EOF 
command. When a READ command follows one or more EOF commands in the order of execution, 
the READ command returns the value obtained by the immediately preceding EOF command; when 
more than one EOF command is executed prior to a READ command, data is lost. 

The following is an example of the EOF command used in an IF statement: 
?IF|6NOTt5EOFfe5THENti5DATA = READ 
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5.9.4 CLOSE COMMAND. The Close command (CLSE) terminates data input. The syntax for the 
CLSE command is as follows: 

7CLSE; 

A CLSE command may be used to terminate data input from a file or device in order to open a different 
file or device for data input. The user may close a file and then open the file in order to rewind the file 
and input the data again. 

5.10 EMULATOR OPERATION COMMANDS 

The emulator replaces the microprocessor of the target system and provides the interface between the 
host system and the target system. This interface allows the host system to: 

Start the microprocessor 

Stop the microprocessor 

Display the current status of the emulator 

Stop the microprocessor on an external signal 

Stop the microprocessor when it accesses a specified address 

Stop the microprocessor when it writes into a specified address 

Stop the microprocessor when it executes the instruction at a specified address 

Store a specified number of memory addresses accessed and stop the microprocessor when 
the addresses have all been stored 

Store a specified number of addresses of instructions executed and stop the microprocessor 
when the addresses have all been stored 

Substitute trace memory for the 512 high-order addresses of target system memory 

Substitute user memory for target system memory, addresses OOOO16 through 1 FFF16. 

The host computer communicates with the emulator through the CRU to control the emulator and 
ultimately the target system. AM PL software supports the following commands to control the 
emulator: 

Initialize Emulator (EINT) 

Define Breakpoint Conditions (EBRK) 

Select Event (EEVT) 

Initialize Compare Logic (ECMP) 

Initialize Trace Logic (ETRC) 

Start Microprocessor (ERUN) 
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• Stop Microprocessor (EHLT) 

• Read Trace Memory (ETB) 

There are several system variables that relate to emulator operation. Where a system variable relates 
directly to a command, the variable is discussed with the command. System variables E TM and EU M 
control the mapping of the target system memory, and relate to all target system operations. These 
variables may be displayed or changed. The following are examples of displaying ETM and EUM: 

T£J\J[:B Display system variable ETM in binary 

mode. Value of i indicates that target 
system memory addresses FEOO16 through 
FFFF,6 (TMS 9900) or 3E00i6 through 
3FFFi6 (TMS 9980) are mapped into 
Emulator trace memory (figure 4-1). 

?EUM:B Display system variable EUM in binary 

<(g0(Z)8ag)gl00fl0g)0(Z!fl1 mode. Value of 1 indicates that target 

system memory addresses through 
IFFF16 are mapped into Emulator user 
memory (figure 4-1). 

To change the values of ETM and EUM to zero, mapping all target system memory addresses into 
target system memory, use assign statements as follows: 

?ETM = Set system variable ETM to zero. 

2EUM = Set system variable EUM to zero. 

System variable EMT identifies the type of microprocessor being emulated. This variable may be 
displayed and tested, but may not be altered by the user. System variable EMT has a value of zero when 
a TMS 9980 buffer is connected to the emulator, and a value of one when a TMS 9900 buffer is 
connected to the emulator. The following are examples of the use of system variable EMT: 

? EMT: Bl Display the value of system variable 

I ~ EMT. The result indicates that a 

~ TMS 9900 microprocessor is being 

emulated. 

1 IF EMT THEN 'TMS 9900' ELSE 'TMS 9980' 
TMS 9980 Display message appropriate to type of 

microprocessor being emulated. 

5.10.1 INITIALIZE EMULATOR COMMAND. The Initialize Emulator command (EINT) selects 
and initializes an emulator to execute subsequent emulator control commands. The syntax for the 
command is as follows: 

?ElNT('<device name>') 

The operand is the device name assigned during system generation. In the TX990 system supplied by 
Texas Instruments, the device name is EMU. For a DXIO system, the device name is EMOl (for the 
first emulator). The EINT command must be entered prior to accessing target memory. Once the 
command has been entered, it need not be entered again unless the AM PL program is reloaded or 
unless there is more than one emulator in the system. When there is more than one emulator, an EINT 
command must be entered prior to using a different emulator. 
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The following are examples of EINT commands using TX990 device names: 

''EINTCEMU') Initialize EMU as the active emulator. 

7EINTCEMU2') Initialize EMU2 as the active emulator. 

The following are examples of EINT commands using DXIO device names: 

■^ EINT('EMOr) Initialize EMOl as the active emulator. 

? EINT('EM02') Initiahze EM02 as the active emulator. 

5.10.2 DEFINE BREAKPOINT CONDITIONS COMMAND. The Define Breakpoint Conditions 
command (EBRK) defines the conditions for breakpoints, and the action the emulator takes when a 
breakpoint occurs. The syntax for the command is as follows: 



The first operand specifies breakpoint conditions. When this operand is the keyword EVT, a 
breakpoint occurs on ian event as defined by the EEVT command. When the operand is the keyword 
FULL, a breakpoint occurs when a specified number of trace addresses have been stored or when the 
trace memory overflows. When the breakpoint condition operand is the keyword EVT+FULL, a 
breakpoint occurs either when an event occurs or when the specified number of trace addresses have 
been stored. When the operand is the keyword OFF, no breakpoint occurs. 

The second operand specifies breakpoint action. When the operand is the keyword SELF, a 
breakpoint consists of stopping the microprocessor (target system) at the completion of the currently 
executing instruction. When the operand is the keyword OFF, a breakpoint consists of sending a 
breakpoint signal to the trace module and incrementing the count in system variable ENI without 
stopping the microprocessor. When the breakpoint action operand is omitted, whichever keyword was 
entered most recently in an EBRK command remains in effect. 

The EBRK command may be entered with no operands to display the breakpoint conditions and 
action in effect. When this is done prior to entering an EBRK command with one or more operands, 
the initial breakpoint conditions and action are displayed, as follows: 

?EBRK; 
+OFF +OFF 
+OFF 

This indicates that the two breakpoint conditions are off and that the breakpoint action is also off The 
first keyword on the first line is either +EVT or +OFF, and means that the breakpoint on an event is on 
or off, respectively. The second keyword on that line is either -f-FULL or +OFF, and means that the 
breakpoint on completion of a trace operation is either on or off, respectively. The keyword on the 
second line is either SELF or OFF and means that the breakpoint action of stopping the 
microprocessor is either on or off, respectively. 
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The following are examples of EBRK commands: 
2^EBRK(EVT) 

? EBRK(FULL) 

2, EBRK(EVT+FULL) 

? EBRK(OFF) 



? EBRK(EVT,SELF) 



EBRK(FULL,OFF) 



Enable breakpoint on event only. The 
event is defined by an EEVT command. 
Breakpoint action remains unchanged. 

Enable breakpoint on completion of trace 
only. Breakpoint action remains 
unchanged. 

Enable breakpoint on event or on 
completion of trace. Breakpoint action 
remains unchanged. 

Disable all breakpoints. Breakpoint 
action (which would apply by default in a 
subsequent EBRK command) remains 
unaltered. 

Stop the microprocessor when an event 
occurs. 

Breakpoint on trace completion. 
Breakpoint results in signal to trace 
module and is counted, but does not stop 
the target system. 



5.10.2.1 System Variable ENI. System variable ENl maintains a count of emulator interrupts. An 
emulator interrupt occurs at each breakpoint while the breakpoint action operand is set to OFF. The 
count is set to zero when the target system is started. The user may display the contents of ENl, but may 
not assign a value to this variable. The following is an example of a display of ENI: 



1 ENI:D 

25 



Display the value of system variable ENi. 



5.10.3 SELECT EVENT COMMAND. The Select Event command (EEVT) selects the event for 
breakpoints. The syntax for the EEVT command is as follows: 



lEEVTuH)] 



When the user enters the keyword INT, the event that causes a breakpoint is the internal comparison 
circuitry of the emulator. When the user enters the keyword EXT, an external signal is the event that 
causes the breakpoint. The signal is connected to a terminal (P7) on the emulator module. 

The user may enter an EEVT command with no operand to display the event selection in effect. When 
this is done prior to entering an EEVT command with an operand, the initial event selection is 
displayed as follows: 

:^EEVT; 
+ 1NT 

This indicates that the internal comparison circuitry of the emulator triggers a breakpoint. When the 
keyword EXT is displayed, the external breakpoint signal triggers a breakpoint. 
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When the EVT keyword of the EBRK command is in effect, an EEVT command that specifies key- 
word EXT sets up a breakpoint on the external signal. When the external signal connected to P7 
goes low the breakpoint is effective. An EEVT command that specifies keyword INT sets up a 
breakpoint on an internal comparison defined in an ECMP command. 

The following are examples of EEVT commands: 

? EEVT (INT) Select internal comparison signal as event. 

? EEVT (EXT) Select external signal as event. 

5.10.4 INITIALIZE COMPARE LOGIC COMMAND. The InitiaHze Compare Logic command 
(ECMP) initializes the emulator comparison logic to compare a specified type of address to a specified 
address. The syntax for the ECMP command is as follows: 

( ADDR ) 

The first operand is the address type (qualifier) operand. When this operand is the keyword ADDR, all 
addresses on the address bus (for read, write, or instruction acquisition accesses) are compared to a 
specified value. When the operand is the keyword ADDR-DBIN the address on the address bus is 
compared only when DBIN is false (write cycles only). When the address type operand is the keyword 
ADDR+IAQ, the address on the address bus is compared only when I AQ (Instruction Acquisition) is 
true (program counter address). When the operand is the keyword OFF, comparison is inhibited. 

The second operand, the address operand, is the value to which the address bus value is compared. 
When the target system uses a TMS 9900 microprocessor, the second operand may be any value in the 
range of through FFFF16. When the target system uses a TMS 9980 microprocessor the range of 
valid addresses is through 3FFFi6. No event can occur if the second operand is greater than 3FFFi6. 

The second operand has no significance when the first operand is the keyword OFF. When the address 
operand is omitted, the address in the most recent ECMP command is used in the comparison. The 
user may enter an ECM P command with no operands to display the address type and address value in 
effect. When this is done prior to entering an ECM P command with operands, the initial address type 
and value are displayed as follows: 

? ECMP; 
OFF 
>0000 

This indicates that the comparison logic is disabled and that the address operand is 0. The keyword on 
the first line may be any of the four keywords used as the address type operand and identifies the type of 
address being compared. The second line displays the current address operand. 

For the comparison specified in an ECMP command to result in a breakpoint, an EEVT command 
must set event to INT and an EBRK command must set the breakpoint condition to EVT or to 
EVT+FULL. 
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The following are examples of ECMP commands: 

? ECMP (ADDR,>FF46) Compare addresses of all memory 

accesses to FF46i6. 

? ECMP (-DBIN,>FFOO) Compare addresses of all write memory 

accesses to FF00i6. 

? ECMP (lAQ) Compare addresses of all instruction 

acquisition memory accesses to the most 
recently entered address operand (FFOO16, 
if the preceding example is the most 
recently entered ECMP command). 

? ECMP (OFF) Inhibit comparison. 

5.10.5 INITIALIZE TRACE LOGIC COMMAND. The Initialize Trace Logic command (ETRC) 
specifies the type of address to be stored, the number of addresses to be stored, and the clock for storing 
the addresses. The syntax for the ETRC command is as follows: 



SADDR ) .TMj^ 

[ADDR+] IAQ>[,<count>[,|^x-|-}]] )] 



The first operand specifies the type of addresses to be stored. When the operand is the keyword 
ADDR, all addresses on the address bus (for read, write or instruction acquisition accesses) are stored. 
When the operand is the keyword ADDR+I AQ or the keyword I AQ, addresses on the address bus are 
stored only when I AQ (Instruction Acquisition) is true (program counter addresses). When the address 
type operand is the keyword OFF, no addresses are stored. 

The second operand is the count operand, which may be any valid expression having a value in the 
range of I through 256. The count operand has meaning only when an EBRK command with a 
condition operand of FULL or EVT+FULL and an action operand of SELF is in effect. Under these 
conditions, the count operand specifies the number of values to be stored during the trace operation. 
When breakpoint conditions and action is effect do not halt the target system, addresses are stored 
until the target system is halted in some other manner, overwriting previously stored addresses when 
the 256-word trace memory becomes full. When the count operand is omitted, the most recently 
entered count operand applies. 

The third operand selects the clock enable signal for storing the addresses. When the operand is the 
keyword INT, the operation is clocked by the internal target system clock. When the operand is the 
keyword EXT, the trace operation is clocked by an external enable signal, normally from the trace 
module. When the clock operand is omitted, the most recent clock selection applies. 

A trace operation consists of storing the specified type of addresses. When the breakpoint condition in 
effect is either FULL or EVT+FULL and the breakpoint action in effect is SELF, the operation 
completes a breakpoint occurs when the number of addresses specified as the count has been stored. 
The stored data is accessible using the ETB command. The data is stored in the trace memory of the 
emulator module. System variable ETM should be set to zero during a trace operation. If ETM is set to 
one and if the target system accesses one or more addresses above FEOO16, interference between the 
target system and the trace operation occurs. 
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Whenever tracing is enabled, addresses are stored in trace memory. When the breakpoint action 
operand of the EBRK command in effect is OFF, completion of a trace operation or overflow of trace 
memory does not halt the target system. If the target system runs long enough, all 256 words of trace 
memory will have been filled with stored addresses when the target system halts. The trace memory 
contains up to 256 traced addresses or the most recently stored 256 traced addresses when it is halted. 

The user may enter an ETRC command with no operands to display the address type, count, and clock 
operands in effect. When this is done prior to entering an ETRC command with operands, the initial 
address type, count, and clock are displayed as follows: 

?ETRC; 
OFF 

256 

+INT 

This indicates that the trace logic is disabled, the trace count is set to 256, and the trace is internally 
clocked. The keyword on the first line may be any of the three keywords used as the address type 
operand and identifies the type of addresses traced. The value on the second Hne is the count of 
addresses to be traced. The keyword on the third line is either + INT or +EXT, and indicates internal or 
external clock, respectively. 

The following are examples of ETRC commands: 

? ETRC (ADDR, 10,INT) Trace ten addresses, storing an address at 

each memory access using internal clock. 

? ETRC (OFF) Turn trace off. 

In using the ETRC command in a TMS 9980 system the count operand may be odd, but an even 
number of addresses is always traced. This is because the TMS 9980 accesses two bytes for each word 
accessed, and tracing does not stop until the currently executing instruction completes execution. The 
following example traces one address in a TMS 9900 system, and two addresses in a TMS 9980 
system: 

2 ETRC (IAQ,1,INT) Trace one instruction, storing an address 

at each memory access of the instruction 
word. If the FULL and SELF options of 
the EBRK command are in effect, this 
results in execution of a single instruction 
each time the microprocessor is started. 

In a TMS 9900 system, emulator trace memory contains the instruction address at the completion of 
the trace operation. In a TMS 9980 system, emulator trace memory contains the addresses of both 
bytes of the instruction (or of the first word of the instruction). Storing of the address of the even byte 
can be inhibited when the emulator and trace modules are set up to trace simultaneously, the clock 
operand of the ETRC command is EXT, and the trace module is set up to trace only when the address is 
odd. paragraph 5.9.5 describes the TTRC command for setting up tracing in the trace module. 
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5.10.6 START MICROPROCESSOR COMMAND, The Start Microprocessor command (ERUN) 
clears the Hold signal to the emulator, starting the microprocessor. Execution begins at the address in 
system variable PC, with the target system workspace pointer set to the value in system variable WP 
and the target system status register set to the value in system variable ST. The syntax for the command 
is as follows: 

?ERUN; 

In many cases, a program would have been loaded into the target system memory. If an entry point 
were not specified in the source code, the user would assign the entry address to variable PC. Similarly, 
system variables WP and ST are set to the required values. The user could define a breakpoint using an 
EBRK command, and EEVT command, and an ECMP command. Alternatively, the user could define 
a breakpoint on completion of a trace operation using an EBRK command and an ETRC command, 
or define both breakpoints. Or the user may allow the program to execute to its normal termination or 
stop it with an EHLT command. 

The following is an example of a set of statements and commands to load and execute a program 
consisting of a single instruction: 

?@>100 = >IOFF Single instruction loop into address IOO16. 

2PC = >I00 Set PC. 

2WP = >200 Set WP. 

1ST = Set ST. 

JERUN Start target system. 

5.10.6.1 System Variable EST. The software maintains the current status of the emulator in system 
variable EST. The user may display the value of EST at any time, but may not assign a value to this 
variable. The following is an example of a display of EST: 

? EST" Display status of emulator in system 

EST ^ >0005 variable EST. Result indicates that the 

target system is running and that the event 
logic has generated a breakpoint. 

The status value is returned in the least significant digit, as shown in table 5-1. System variable EST 
may also be used with a mask value to test for a specific status condition, as in the following example: 

I IF|6EST|i5AND|!51feSTHENt!i 'EMULATOR IS RUNNING' Print message if least significant 

bit of system variable EST is true. 

A mask value of I tests the status bit that is true when the emulator is running. A mask value of 2 tests 
the status bit that is true when a trace overflow breakpoint has occurred. A mask value of 4 tests the 
status bit that is true when an event breakpoint has occurred. Amask value of 8 tests the status bit that 
is true when an Idle instruction is being executed. 

5.10.7 STOP MICROPROCESSOR COMMAND. The Stop Microprocessor command (EHLT) 
sends the Hold signal to the emulator, baking the microprocessor. The syntax for the EHLT command 
is as follows: 

?EHLT; 
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Contents of 

Least Significant Digit 

of System Variable EST 

(Hexadecimal) 





D 



Table 5-1 . Emulator Status 



Status 

Target system is halted. Neither an event or trace overflow 
has caused a breakpoint. 

Target system is running and is not executing an Idle in- 
struction. Neither an event or trace overflow has caused a 
breakpoint. 

Target system is halted, a trace overflow breakpoint has 
occurred, and an event breakpoint has not occurred. 

Target system is running and is not executing an Idle in- 
struction. A trace overflow breakpoint has occurred and 
an event breakpoint has not occurred. 

Target system is halted. An event breakpoint has oc- 
curred, and a trace overflow breakpoint has not occurred. 

Target system is running and is not executing an Idle in- 
struction. An event breakpoint has occurred, and a trace 
overflow breakpoint has not occurred. 

Target system is halted and both an event and a trace 
overflow breakpoint have occurred. 

Target system is running and is not executing an Idle in- 
struction. Both an event and a trace overflow break- 
point have occurred. 

Target system is running, executing an Idle instruction. 
Neither an event or trace overflow has caused a break- 
point. 

Target system is running, executing an Idle instruction. 
A trace overflow breakpoint has occurred, and an event 
breakpoint has not occurred. 

Target system is running, executing an Idle instruction. 
An event breakpoint has occurred, and a trace overflow 
breakpoint has not occurred. 

Target system is running, executing an Idle instruction. 
Both an event and a trace overflow breakpoint have oc- 
curred. 
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When an expected breakpoint is never reached, or when no breakpoint is in effect, the microprocessor 
may be stopped by executing an EHLT command. The command displays the emulator status (system 
variable EST). Since the status is read after the microprocessor is halted, only the even numbers in 
table 5-1 apply. The following is an example of an EHLT command: 

2 EHLT Halt the microprocessor. The displayed 

>0002 status indicates that the target system is 

halted, an event breakpoint has not 
occurred, and a trace overflow breakpoint 
has occurred. 

5.10.8 READ TRACE MEMORY COMMAND. The Read Trace Memory command (ETB) is a 
system function that reads the specified value from the emulator trace memory. The syntax for the 
command is as follows: 

?ETB(<index>) 

The index operand may be any valid expression. When the value of the expression is a valid index to 
the emulator trace memory, the command prints the value stored in the word corresponding to the 
index value. The limits of valid index values can be determined by displaying the values of two system 
variables. System variable ETBN contains the index value corresponding to the most recently stored 
word. ETBN contains at the completion of a trace operation. System variable ETBO contains the 
index value corresponding to the first word stored (oldest word). 

The emulator stores values in trace memory when tracing is initialized by an ETRC command, and the 
target system is started. The last value stored during the trace operation is accessible using an index 
value of 0. The values stored prior to the completion of the trace operation are accessed using negative 
index values, with the most negative index value corresponding to the value first stored. 

TMS 9900 addresses are 16-bit addresses, and occupy all 16 bits of the trace memory words. TMS 9980 
addresses are 14-bit addresses; the trace memory stores these addresses in the least significant 14 bits of 
trace memory words, with zeros in the two most significant bits. The TMS 9980 accesses two bytes for 
each word accessed by the TMS 9900. Unless the trace module is used to inhibit tracing both addresses, 
the trace memory in the emulator contains an even and an odd address for each word accessed. 

Alternatively, an ETB command and its operand may be used as a variable in an expression in an 
AMPL statement. The value stored in trace memory corresponding to the value of the operand 
becomes the value of the command when used as a variable. 

The user should enter an ETB command immediately following the trace operation. If an ERUN 
command is entered following the trace operation and before the ETB command, traced values will be 
lost unless the trace is turned off before starting the microprocessor. Also, if system variable ETM is set 
to one following the trace, and if an ERUN command is entered, contents of the trace memory may be 
ahered if the microprocessor accesses target system memory addresses FE00i6 through FFFF,6 
(TMS 9900) or 3E00,6 through SFFFje, VEOGi^ through 7FFF,6. BE00,6 through BFFF,6. or 
FEOOie through FFFF,6 (TMS 9980). 
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The following are examples of ETB commands: 

_^ ETB (v) Display the most recently stored address. 

>1Q56 

? ETB (-1) Display the address stored prior to the 

>1054^ address displayed in the preceding 

example. 

The following is an example of a series of AM PL statements that use the ETB command as a variable: 

?^ N = ETBO Initialize variable N to the index of the 

1 WHILEiiNt5LEt5ETBNt[5DOk5BEGIN oldest item stored. Display the stored 

1? ETB(N):HN value and increment N. Perform display 

1? N = N+1 until all traced values have been displayed. 

1? END 

When the user enters an index value greater than the value of ETBN or less than the value of ETBO, the 
software prints an error message. 

5.10.8.1 System Variable ETBO. System variable ETBO is set to the index value of the oldest value 
stored in memory by the emulator module. ETBO may not be assigned a value by the user, but may be 
displayed whenever the emulator is not running. The value of ETBO is the smallest (most negative) 
value that may be used as an index in an ETB command. When this value is 1 and the value of ETBN is 
0. no values have been stored and an ETB command cannot be executed. The following is an example 
of a display statement to display ETBO: 

]_ ETBO Display the index to the oldest address 

ETBO= >FFFE stored in emulator trace memory. 

5.10.8.2 System Variable ETBN. System variable ETBN is set to the index value of the most recently 
stored value in memory by the emulator module. ETBN may not be assigned a value by the user, but 
may be displayed whenever the emulator is not running. The value of ETBN is zero, the largest (most 
positive) value that may be used as an index in an ETB command. The following is an example of a 
display statement to display ETBN: 

^ fflfflfflfi Display the index to the newest address 

LIdN- xpyiW stored in emulator trace memory. 

5.11 TRACE MODULE OPERATION COMMANDS 

The trace module stores and analyzes up to 256 20-bit values under control of the host computer and 
optionally in conjunction with the emulator module. The clock used for storing and analyzing traced 
values may be either an internal 1 MHz clock or an external clock up to 1 MHz. Four qualifiers may 
be used to select a clock as a trigger for storing and analyzing a value. Analyzing a value consists of 
comparing selected bits of the value to corresponding bits of a value stored in a comparison register. 

The trace module may be connected in any of three modes as shown in figure 5-1. in the stand-alone 
mode, the data cable with probe leads is connected to the trace module and no control cable is 
connected. This allows tracing of up to 20 logic signals to which probe leads are connected, under 
control of up to four qualifiers (logic signals to which other probe leads are connected). Two additional 
probe leads may be connected to an external clock and an external event signal. 
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Figure 5-1. Trace Module Connections 
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In the emulator control-external data mode, the data cable with probe leads is connected to the trace 
module to provide data and control input as in the stand-alone mode. A control cable connects the 
trace module to the emulator module to synchronize tracing. Inthismode, tracing does not begin until 
the target system is started by the emulator, and the trace module may request the emulator to halt the 
target system at the completion of the current instruction. 

In the emulator control and data mode, both the input data cable and the control cable connect the 
trace module to the emulator module. This allows tracing of either memory addresses or memory data 
using qualifiers and external clock from the emulator module. When the target system uses a 
TMS 9900 microprocessor, only three qualifiers are used. When the target system uses a TMS 9980 
microprocessor, all four qualifiers are used. The qualifiers are connected to the following emulator 
signals: 

• The inversion of the least significant address bit, true when an even address is on the address 
bus (TMS 9980); true at all times (TMS 9900). 

• Instruction Acquisition (lAQ), true during a memory cycle that reads an instruction from 
memory. 

• Data Bus In (DBIN), true during memory read cycles. 

• Emulator Event (EMU), true during memory cycles in which comparison logic in the 
emulator indicates an equal comparison. 

When the data cable connects the trace module to the emulator module, the external event signal is 
connected to the emulator event signal in the emulator, and the external clock signal is connected to the 
emulator clock. 

In the stand-alone mode, operation of the trace module begins when a Start Trace command is 
executed. Otherwise, tracing begins when the target system is started following execution of a Start 
Trace command. 

The input data is stored on each selected clock. When the breakpoint is defined, tracing may be stopped 
at the occurrence of a breakpoint. Otherwise, the user may stop tracing by executing a Stop Trace 
command, or the emulator may halt the trace module (except in the stand-alone mode). Storing of data 
continues until the module halts, overlaying previously stored data after 256 values have been stored. 
Thus, when the module halts, the trace memory contains the 256 most recently stored values. 

When the trace module is connected in the emulator control and data mode, either addresses or data 
may be stored in the trace module. When the target system uses a TMS 9900 microprocessor, the 
addresses and the data are both 16-bit words. When the target system uses a TMS 9980 
microprocessor, the address is a 14-bit address and the data is accessed in 8-bit bytes. The 14-bit 
address is placed on the address bus in the 14 least significant bits and the two most significant bits are 
at logic zero. The 8-bit data bytes are combined to form a 16-bit word under control of the least 
significant bit of the address. On an even address (least significant bit equals zero) the 8 data bits are 
placed in the most significant half of the data bus. On an odd address (least significant bit equals one) 
the 8 data bits are placed in the least significant half of the data bus, and the most significant half retains 
its previous contents. Thus during memory accesses at even addresses the data bus only contains the 
most significant half of the word. During memory accesses at odd addresses the data bus contains the 
word at the next lower even address. 

A trace operation may be defined in terms of a number of values to be stored, and a breakpoint may be 
specified to occur when the trace operation completes. 
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The comparison logic ot the trace module compares selected liitsol the data hcing stored with the data 
in the comparison register. An event occurs uhen the result of the comparison is equal. Alternati\el\. 
an external signal identifies an event, [he trace module contains both an event counter and a delay 
counter, each of which is set to a value supplied by the user, fhe event counter decrements when an 
event occurs. When the event counter counts down to zero, the delay counter begins decrementing each 
time a value is stored in trace memory. When the delay count reaches zero, the event and delay 
completion occurs, which may optionally cause a breakpoint. 

When a breakpoint occurs at completion of a trace operation or ofan even! and delay, the trace module 
may interrupt the host computer without stopping the trace or reijuesting the emulator to stop. 
Optionally, the breakpoint may interrupt the host computer and stop the trace but not request the 
emulator to stop. Another option is that of requesting the emulator to stop the target system at 
completion of the currently executing instruction without interrupting the host computer. Tracing 
continues until the emulator stops the target system in this case. A fourth option requests the emulator 
to stop the target system at completion of the currently executing instruction and also stops the trace. 
Only the first two options apply to the stand-alone mode. 

When tracing is stopped by the emulator following a request from the trace module, it is possible for as 
many as eight memory clock cycles to occur in the emulator between the time the request is issued and 
the time the trace stops. If the trace module is following the emulator clock, there could be eight values 
stored during this time depending on the qualifiers specified. When the trace module is internally 
clocked, the number of values stored during this time is a function of the emulator clock period, the 
qualifiers, and the currently executing instruction. When the sum of the number of additional clock 
cycles plus the specified delay exceeds 255, the trace memory is filled with values stored after the last 
event and previously stored values are lost. 

The host computer communicates with the trace module through the CRU to define the addresses and 
options for the trace. The AMPL software supports the following commands to control the trace 
module: 

Initialize Trace Module (TINT) 

Define Trace Breakpoints (TBRK) 

Select Trace Event (TEVT) 

Initialize Trace Compare Logic (TCMP) 

Initialize Trace Module Trace Logic (TTRC) 

Start Trace (TRUN) 

Stop Trace (THLT) 

Read Low Order Trace Module Memory (11 B) 

Read High Order 1 race Module Memory (TTBH) 
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5.11.1 INITIALIZE TRACE MODULE COMMAND. The Initialize Trace Module command 
(TINT) selects and initializes a trace module to execute subsequent trace module control commands. 
1 he syntax for the command is as follows: 

?TINT( '<device r,;.me>') 

The operand is the device name assigned during system generation. In the TX990 system supplied by 
Texas Instruments the device name is TR A. For a DX 1 system, the device name is f MO 1 (for the first 
trace module). Once the command has been entered it need not be entered again unless the AM PL 
program is reloaded or unless there is more than one trace module in the system. When there is more 
than one trace module, a TINT command must be entered prior to using a different trace module. 

The following are examples of TINT commands using TX990 device names: 

?TT|\|T/ 'TRfl I \ 

- ^ " '' Initialize TRA as the active trace module. 



?TINT('TRA2') 



Initialize 
module. 



TRA2 as the active trace 



The following are examples of TINT commands using DXIO device names: 



? TINT('TMOr) 



Initialize TMOI as the active trace 
module. 



? TINT('TM02') 



Initialize TM02 
module. 



as the active trace 



5.11.2 DEFINE TRACE BREAKPOINT COMMAND. The Define Trace Breakpoim command 
(TBRK) defmes the conditions that cause a breakpoint and the action that the breakpoint causes. The 
syntax for the TBRK command is as follows: 

EVT ) ( SELF ) 
^^PP .,, FULL In ) EMU (-,.-, 

^ibR'<l()evt+full('-')self+emu(-'^-' 

OFF j ( OFF j 

The first operand specifies breakpoint conditions. When the keyword EVl is entered, a breakpoint 
consists ofanevent and delay completion. When the keyword FULL is entered, a breakpoint consists 
of a trace completion. When the keyword EVT+FULL isentered, a breakpoint may beeitheranevent 
and delay completion or a trace completion. When the keyword OFF is entered, neither completion 
causes a breakpoint. 

The second operand specifies a breakpoint action. When the keyword SELF is entered, a breakpoint 
causes the trace operation to stop and an interrupt to be sent to the host computer. When the keyword 
EM U is entered, a breakpoint causes the trace module to request the emulator to halt at the completion 
of the currently executing instruction. When the keyword SELF+EMU isentered, a breakpoint causes 
the trace operation to stop and requests the emulator to halt at the completion of the currently 
executing instruction. When the keyword OFF is entered, a breakpoint causes the trace module to 
interrupt the host computer. When the breakpoint action operand is omitted, the most recently entered 
breakpoint action operand of a TBRK command continues to apply. 
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All four keywords that may be used as the breakpoint condition operand apply to all connection 
modes. However, when the keyword OFF is entered and the trace module is connected in the stand- 
alone mode, a THLT command must be entered to stop the trace. When the keyword OFF' is entered in 
either of the other connection modes, tracing stops whenever the emulator stops. When the EVT or 
FVT+FUF.F. keyword is entered, this command operates in conjunction with a TEVT and TCMP 
command to breakpoint after a specified delay following a specified event. When the FIJFL or 
FVT+FUF,F. keyword is entered, this command operates in conjunction with a Tl RC command to 
breakpoint when a specified number of values have been stored in trace memory. System variable TNE 
(described in a subsequent paragraph) maintains a count of events. 

Keywords EMU and SELF+EMIJ are not relevant as the breakpoint action operand in the stand- 
alone connection mode. All breakpoint action keywords are relevant in the other two connection 
modes. When keywords EMU and SEl.F^+EMU are used, a breakpoint causes the trace module to 
request the emulator to halt the target system. Unless the SEEF keyword of an EBRK command is in 
effect as the breakpoint action operation for the emulator, the emulator will not halt the target system. 
When the OFF keyword has been entered, the trace module interrupts the host computer when a 
breakpoint occurs. 

F he F BRK command may be entered with no operands to display the breakpoint conditions and 
action in effect. When this is done prior to enteringa TBRK command with one or more operands, the 
initial breakpoint conditions and action are displayed, as follows: 

2 TBRK; 
+OFF +OFF 



+OFF +OFF 



1 his indicates that the two breakpoint conditions are off, and the two breakpoint actions are off. The 
first keyword on the first line is either +EVT or +OFF and means that an event and delay completion 
breakpoint is on or off, respectively. The second keyword on that line is either + FUF,L or +OFF, and 
means that the breakpoint on completion of a trace is either on or off, respectively. The first keyword 
on the second line is either +SEEF or +OFF. and means that thestop trace breakpoint action is either 
on or off, respectively, fhe second keyword on the second line is either +EMU or +OFF, and means 
that the send request to emulator breakpoint action is either on or off, respectively. 

F he iollowing are examples of TBRK commands: 



:,' IBRK (EVT+FUEE,SEEF+EMU) 



FX'fine a breakpoint to occur on 
completion ol an event and delay or of a 
trace operation, and to stop the trace 
operation immediately and request the 
emulator to stop at completion of the 
current instruction. 



FBRK (FUEF,) 



F)efine a breakpoint to occur on 
completion of a trace operation only. 
Breakpoint action is that defined in 
previous command. 



? FBRK (EVT,OFF) 



F)efine breakpoint to occur on completion 
of an event and delay operation only, and 
to interrupt the host computer without 
stopping the trace. 



.' FBRK (OF F) 



Inhibit breakpoints. 
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5.11.2.1 System Variable TNE. System variable TNE is set to zero when the trace is started, and 
counts events. TNE may not be assigned a value by the user, but may be displayed whenever the trace 
module is not running. The following is an example of a display statement to display TNE: 

]_ TNE Display the count of events that have 

>g)0g4 occurred since the most recent TRUN 

command. 

Counting of events is independent of the count specified for a breakpoint, and does not stop until the 
trace stops. When a delay is specified, events that occur during the delay period cause the final event 
count to exceed the count specified as a breakpoint. The count is maintained as an unsigned number. 

5.1 1.2.2 System Variable TNI. System variable TNI is set to zero when the trace is started, and counts 
interrupts. TNI may not be assigned a value by the user, but may be displayed at any time. The 
following is an example of a display statement to display TNI: 

9 j»iT Display the count of interrupts that have 
ynn-i'k occurred since the most recent TRUN 
command. 

The count in system variable TNI is maintained as an unsigned number. 

5.1 1.3 SELECT TRACE EVENT COMMAND. The Select Trace Event command (TEVT) selects an 
event by specifying an event count, a delay count, and the event mode. The syntax for the TEVT 
command is as follows: 

lTEVT[(<events>[,<delays>[,|^j^yJ +\ioq,e\ +LeXtJ-'J^^ 

The first operand specifies the number of events. The operand may be any valid expression having a 
value of zero through 65,535 to be placed in the event counter. Since the maximum positive value that 
can be expressed as a decimal number is 32,767, values greater than this must be entered as 
hexadecimal, octal, or binary values. A value of zero provides an event count of 65,536. 

An event may be the equal comparison result of an internal comparison specified in a TCMP 
command (paragraph 5.9.4) or an external signal to which the EVENT probe lead is connected, 
determined by the mode operand described in a subsequent paragraph. The user specifies a number of 
events to be counted before initiating the delay period. Thus the first event or a specific subsequent 
event is the first condition for a potential breakpoint. 

The second operand provides the delay value. It may be any expression having a value of zero through 
255 to be placed in the delay counter. When the delay operand is omitted, the most recently entered 
delay operand continues to apply. 

The delay count specifies a number of items to be traced after the event count has been satisfied. The 
potential breakpoint occurs after the specified items have been traced. The user specifies a delay to 
obtain a trace of desired items immediately following the event. 
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The third operand selects the event mode. The operand consists of a single keyword, the sum of two 
keywords, or the sum of three keywords. Keyword NORM specifies decrementing the event counter 
when the selected event signal is true. Keyword INV specifies decrementing the counter on a false 
signal. When neither NORM nor INV is specified, a true signal decrements the count. Keyword EACH 
specifies decrementing the counter at each selected event signal. Keyword EDGE specifies 
decrementing the counter only when the specified value of the specified event signal is different from 
the value at the previous clock. When neither EACH nor EDGE is specified, the count is decremented 
at each signal. Keyword INT selects the equal comparison result of the internal comparison logic as the 
event. Keyword EXT selects the external event signal as the event. In the stand-alone and emulator 
control (external data connection modes), the external event signal is connected by the user to an 
appropriate logic signal. In the emulator control and data connection mode, the external event is the 
emulator event signal. When neither INT or EXT is specified, the internal event is selected. When the 
entire operand is omitted, the most recently entered event mode operand continues to apply. 

The TEVT command may be entered with no operands to display the event count, delay count, and 
event mode in effect. When this is done prior to entering a TEVT command with one or more operands, 
the initial event count, delay count, and event mode are displayed, as follows: 

? TEVT; 
i 

I) 
+NQRM+EACH+INT 

This indicates that the event count is one, the delay count is zero, and the internal event signal true 
constitutes an event at each clock. The event count is displayed on the first line and the delay count is 
displayed on the second line. The event mode is displayed on the third line. Table 5-2 shows the eight 
possible modes and the meaning of each. 

The operands of a TEVT command specify a potential breakpoint after a delay specified as a number 
of trace memory stores following an event that satisfies the event count. 

The third operand defines the conditions for an event. A TBRK command that specifies EVT or 
EVT-I-FULL must be in effect for an actual breakpoint to occur. 

The following are examples of TEVT commands: 



? TEVT (0,0,NORM-|-EACH-hINT) 



Count at each selected clock when the 
internal comparison signal is true. Event 
and delay completion occurs with no 
delay after the 65,536th event. 



? TEVT (I) 
? TEVT (5,35) 



Alter event count to I, leaving previously 
entered delay and mode unaltered. 

Alter event count to 5 and delay count to 
35 leaving previously entered mode 
unaltered. 



? TEVT (>8E4F) 



Alter event count 
leaving previously 
mode unchanged. 



to 8E4F,6 (36431) 
entered delav and 
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Event Mode 

+NORM+EACH+INT 

+NORM+EACH+EXT 

+NORM+EDGE+INT 

+N0RM+ED6E+EXT 

+INV+EACH+INT 

+INV+EACH+EXT 

+INV+ED6E+INT 

+INV+EDGE+EXT 



Table 5-2. Event Modes 

Meaning 

Decrement at each selected clock during which the internal event 
signal is true. 

Decrement at each selected clock during which the external event 
signal is true. 

Decrement at selected clock when the internal event signal has 
changed from false to true since the preceding selected clock. 

Decrement at selected clock when the external event signal has 
changed from false to true since the preceding clock. 

Decrement at each selected clock during which the internal event 
signal is false. 

Decrement at each selected clock during which the external event 
signal is false. 

Decrement at selected clock when the internal event signal has 
changed from true to false since the preceding selected clock. 

Decrement at selected clock when the external event signal has 
changed from true to false since the preceding selected clock. 



Note: A selected clock is a clock signal selected for storing a value in trace memory. Specified 
qualifiers in specified states select a clock pulse. 



5.11.4 INITIALIZE TRACE COMPARE LOGIC COMMAND. The Initialize Trace Compare 
Logic command (TCMP) specifies values to be placed in the comparison register and in the compare 
mask register. The syntax for the TCMP command is as follows: 



?TCMP [{< 



-'^^ ^ [j-l iaqJ y-l dbinJ 1j-(emuJ 



>[,<low 16 value>[,<low 16 mask>]])] 



OFF 



The first operand specifies the mask and values for the high-order four bits of the compare register, and 
optionally, the source of data to be compared. Optionally, the keyword ADDR or the keyword DATA 
may be entered, specifying the type of data being supplied to the trace module in the emulator control 
and data mode. The remainder of the operand is a series of one to four keywords to specify the mask 
and values of the high-order bits. Keywords QO through Q3 denote the high order bits, with QO the 
most significant bit. When a plus sign precedes a keyword, the corresponding bit in the compare 
register is set to one. When a minus sign precedes a keyword, the corresponding bit in the compare 
register is set to zero. The sign may be omitted preceding the first keyword; the plus sign applies. When 
the keyword corresponding to a bit is omitted, that bit is masked off and does not participate in the 
comparison. When the keyword OFF is entered, neither data source is specified, all four bits are 
masked off and the four high-order bits of the compare register do not participate in the comparison. 
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When the target system uses a TMS 9980 microprocessor and keyword DATA is entered, the 
appropriate state of keyword QO should be specified also. When DATA+QO is entered, an equal 
comparison is possible only when an even memory address is being accessed. The data bus at this time 
contains the byte at the even address in the most significant eight bits and random data in the least 
significant eight bits. When DATA-QO is entered, an equal comparison is possible only when an odd 
memory address is being accessed. The data bus at this time contains the two bytes of a memory word, 
with the even-addressed byte in the most significant eight bits and the odd-addressed byte in the least 
significant eight bits. Thus when emulating a TMS 9980 and comparing to data, DATA-QO should be 
entered to avoid undesired equal comparisons. 

The second operand is the value to be placed in the low-order 16 bits of the compare register. The 
operand may be any valid expression. When the second operand is omitted, the most recently entered 
value continues to apply. 

The third operand is the value to be placed in the low-order 16 bits of the compare mask register. The 
operand may be any valid expression. 

When the target system uses a TMS 9980 microprocessor the mask value can be used to select the valid 
bits. When the ADDR keyword is entered, the TMS 9980 address is in the 141east significant bits with 
the two most significant bits set to zero. By using a mask operand less than 4000i6, the user specifies a 
comparison that ignores the two most significant bits and compares only valid address bits. 

One bits in the mask register correspond to bits that are compared. When the third operand is omitted, 
the most recently entered value is the low-order 16 bits ofthe compare mask register continue to apply. 

In the emulator control and data connection mode, the four high-order bits ofthe data word and the 
four qualifiers are common. When the target system uses a TMS 9900 microprocessor, QO and the 
high-order bit are connected to logic one. When the target system uses a TMS 9980 microprocessor, 
QO and the high-order bit are connected to the inversion ofthe least significant address bit. Q I , Q2, and 
Q3 are connected to lAQ, DBIN, and EM. EVENT, respectively. Table 5-3 lists alternate keywords 
that may be used in the first operand. When the trace module is connected in this manner, the first 
operand of the TCMP command must contain a subset of the qualifiers specified in the TTRC 
command. Otherwise, the comparison always fails because the comparison is made to qualified values. 



Table 5-3. Alternate Keywords for Qualifiers 
Keyword Connected To Alternate Keyword 

QQ Logic one (TMS 9900) 

Inversion of A 1 3 (TMS 9980) "® 

Ql Instruction Acquisition lAQ 

Q2 Data Bus In DBIN 

Q3 Emulator Event EMU 
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In the emulator control and data connection mode, the data input is supplied by the emulator. When 
an ETRC command with either the keyword lAQ or the keyword ADDR is in effect, the emulator 
supplies memory data to the trace module. When an ETRC command with the keyword OFF is in 
effect, the emulator may supply either memory data or memory addresses to the trace module, as 
specified by the TTRC command. Keywords ADDR and DATA in the TCMP command are checked 
for compatibility with the current ETRC and TTRC commands. 

In the stand-alone or emulator control external data connection mode, the four most significant bits of 
the data word and the four qualifiers are separate probe leads and are connected by the user as the test 

requires. 

The TCMP command specifies an event to provide an event and delay breakpoint as defined in a 
TEVT command that specifies INT in the event mode. A TBRK command that specifies either EVT or 
EVT-I-FULL must be in effect for the breakpoint to occur. 

The TCMP command may be entered with no operands to display the compare register and compare 
mask register contents in effect. When this is done prior to entering a TCMP command with on or 
more operands, the initial compare register contents and compare mask register contents are 
displayed, as follows: 

? TCMP; 
OFF 
>FFFF 
+0000 



This indicates that the high-order four bits are masked off, the low-order 16 bits of the compare register 
contain FFFFi6, and no low-order bits are compared. The first line is either OFF or is some 
combination of keywords DO through D3, in which DO through D3 specify the high-order four bits of 
the compare and compare mask registers. The signs and the omission of a keyword have the same 
significance as in the first operand of the command. The second line shows the contents of the 16 low- 
order bits of the compare register. The third line shows the contents of the 16 low-order bits of the 
compare mask register. 



The following are examples of TCMP commands: 
ITCMP (Q0+QH-Q2+Q3),>4142,>FFFF) 

? TCMP (IAQ,>2FE0) 



? TCMP (OFF) 



Set the comparison mask to compare all 
20 bits, comparing to F4142i6. 

Set the comparison mask to compare only 
bit 1 and the bits not masked off by the low 
16 mask operand in effect. Compare data 
to 2FE0i6 and lAQ true. (Emulator 
control and data mode.) 

Set the comparison mask to ignore all four 
high order bits, and compare the low 
order 16 bits to the most recently entered 
compare value and mask value. 
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7TCMP (DATA-O0+IAQ,>10FF,>FFFF) Compare instruction data on data bus to 

IOFF16 (J MP $ instruction) when the 
entire word has been accessed and placed 
on the data bus (IMS 9980). If addresses 
are being stored in emulator trace memory 
simultaneously, the stored address is an 
odd address, one greater than the address 
of the instruction. 

5.11.5 INITIALIZE TRACE MODULE TRACE LOGIC COMMAND. The Initialize Trace 
Module Trace Logic command (TTRC) specifies the qualifiers, count, and clock for a trace operation. 
The TTRC command also enables or disables the pulse-latching function. Optionally, the TTRC 
command initializes the emulator module to provide the specified input data. The syntax for the 
command is as follows: 



?TTRC[(< 



ADDR 
DATA 



II-IQ0J LmqJ LHQ2J I.I-IQ3J. ..^^. ._. 

[(-) lAQj [l-i DBINJ [(-I emu] I 



OFF 



The first operand specifies the mask and values for the qualifiers that select the clock for the trace 
operation, and optionally, the source of data to be traced. When the keyword ADDR is entered as the 
optional word, the memory address bus of the target system is selected for tracing. When the keyword 
DATA is entered, the memory data bus is selected. The remainder of the operand is a series of one to 
four keywords to specify the mask and values of the qualifiers. Keywords QO through Q3 denote the 
qualifiers, with QO the most significant qualifier bit. When a plus sign precedes the keyword, the 
corresponding bit in the qualifier register is set to one. When a minus sign precedes the keyword, the 
corresponding bit in the qualifier register is set to zero. The sign may be omitted preceding the first 
keyword; the plus sign applies. When the keyword corresponding to a bit is omitted, that bit is masked 
off and is not used as a qualifier. When the keyword corresponding to a bit is omitted, that bit is 
masked off and is not used as a qualifier. When the keyword OFF" is entered, neither data source is 
specified, all four qualifiers are masked off and tracing occurs on every clock. 

The second operand specifies the number of values to be stored during the trace operation. The 
operand may be any valid expression having a value in the range of 1 through 256. The second 
operand is ignored unless the first operand of the TBRK in effect is either FULL or EVT+FULL 
and the second operand of that command is SELF, EMU, or EMU + FULL. When the second 
operand is omitted, the most recently entered value continues to apply. 

The third operand selects the clock source for the trace operation. When the keyword INT is entered, 
the internal clock is the clock for the trace operation. When the keyword EXT is entered, the external 
clock is the clock for the trace operation. When neither keyword is entered, the most recent clock 
selection continues to apply. 

The fourth operand controls the latch mode of the trace module. When the keyword OFF is entered, 
the latch mode is disabled. When the ON is entered, the latch mode is enabled. When neither keyword 
is entered, the most recent latch mode keyword continues to apply. 

The choice of DATA or ADDR in the first operand applies only in the emulator control and data 
mode. When either keyword is entered, AM PL software verifies that the data cable is connected to the 
emulator. If an ETRC command with the keyword OFF is in effect, the software issues the necessary 
control signal to the emulator to provide the specified data. Otherwise, the software verifies that the 
specified data is being supplied by the emulator. When the cable is not connected, or when the other 
type of data has been selected by an ETRC command, the software prints a warning message. 
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The qualifiers specified in the first operand must all be in the specified state at clock time in order to 
select a clock for storing a traced value. When the trace module is connected in the emulator control 
and data mode, the qualifiers are connected as shown in table 5-3, and the alternate keywords may be 
used in the first operand. 

When the target system uses the TMS 9980 microprocessor, and the keyword DATA is specified, 
entering -QO as a qualifier results in more efficient use of the trace memory. The data stored in trace 
memory when qualifier -QO is in effect consists of words that contain the bytes in the proper order. If 
quaUfier +Q0 is entered, the most significant byte of the addressed word is stored with random data in 
the least significant byte. If the qualifier QO is omitted, two words are stored for each word in memory; 
the first word contains the most significant byte of the addressed word with random data in the least 
significant byte, and the second word contains the complete word. 

The count operand is used to determine the completion of the trace operation (trace full condition). 
The count is placed in the trace buffer counter, which is decremented as values are stored. When the 
counter is at one and the memory stores a value, the trace full signal occurs which causes a breakpoint if 
a TBRK command that specifies FULL or EVT-t-FULL is in effect. 

The clock operand selects the clock for the trace operation. The internal clock is a 1 MHz clock in the 
trace module. In the stand-alone and emulator control-external data modes, external clock is the signal 
10 which the probe lead designated CLOCK is connected. In the emulator control and data mode, the 
external clock is the emulator end-of-memory cycle clock. 

The latch operand enables or disables the latch mode. The four most significant lines of data are 
equipped to latch narrow data pulses when the latch mode is enabled. They function like the other 16 
lines when the latch mode is disabled. In the emulator control and data mode, the lines that are 
equipped with latches are connected to the same signals as the qualifiers. 

The TTRC command may be entered with no operands to display the qualifiers, count, clock, and 
latch in effect. When this is done prior to entering a TTRC command with one or more operands, the 
initial qualifiers, count, clock, and latch are displayed, as follows: 

I TTRC ; 
OFF 

256 
+INT 
+OFF 

This indicates that the qualifiers are masked off, and that the trace count is 256. Internal clock is to be 
used, and the latch mode is disabled. The first line is either OFF or some combination of the keywords 
used in the first operand. The secon dline displays the count in effect. The third line is either INT or 
EXT, corresponding to internal or external clock, respectively. The fourth line is either ON or OFF, 
indicating that the latch mode is enabled or disabled. 

The following are examples of TTRC commands: 

? TTRC (Qef-Ql-Q2+Q3,128,INT,0FF) ^'^""^ '^^ ^^'"^' ^^^^ occur when 
~ qualifiers and 3 are true and qualifiers 1 

and 2 are false, using the internal clock. 

Set latch mode OFF. 
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1 TTRC (DATA-DBIN) 



Set to trace memory data written during 
write accesses using previously entered 
additional operands (emulator control 
and data mode). 

Trace 25 values on internal clock, ignoring 
qualifiers with latch mode. 

Trace data words in trace memory, using 
external clock with latch inhibited. 
Generate the trace memory full signal 
when 256 words have been stored. Store 
when the entire memory word is on the 
data bus (TMS 9980). 

5.11.6 START TRACE COMMAND. The Start Trace command (TRUN) enables the trace 
operation. The syntax for the TRUN command is as follows: 



? TTRC (OFF,25,INT,ON) 

? TTRC (DATA-Q0,256,EXT,OFF) 



? TRUN; 



Start the trace module. 



In the stand-alone connection mode, the trace module starts when the TRUN command is executed In 
the emulator control external data mode or emulator control and data mode, the trace module starts 
when a TRUN command has been executed and the emulator is started. System variable TST supplies 
the state of the trace module as described in a subsequent paragraph. 

The following is an example of a TRUN command used to start tracing when the emulator is 
connected: 



2 TRUN; 
2 ERUN; 



Omit in stand-alone mode. 



5.11.6.1 System Variable TST. System variable TST is set to the current state of the trace module by 
the AMPL software. TST may not be assigned a value by the user, but may be displayed at any time. 
The display contains the status in the least significant three bits, as shown in table 5-4. The following is 
an example of a display statement to display TST: 



I TST; 
>ef001 



Display trace module status. Trace is 
running and neither event and delay nor 
trace operation has completed. 
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Table 5-4. Trace Module Status 



Contents of Least 
Significant Digit 
Of System Variable TST 





Status 

Trace module is halted. Neither event and delay nor trace operation 
has completed. 

Trace module is running. Neither event and delay nor trace opera- 
tion has completed. 

Trace module is halted and trace operation has completed. Event 
and delay operation has not completed. 

Trace module is running and trace operation has completed. Event 
and delay operation has not completed. 

Trace module is halted and event and delay operation has com- 
pleted. Trace operation has not completed. 

Trace module is running and event and delay operation has com- 
pleted. Trace operation has not completed. 

Trace module is halted, event and delay operation has completed, 
and trace operation has completed. 

Trace module is running, event and delay operation has completed, 
and trace operation has completed. 



System variable TST may also be used with a mask value to test for a specific status condition as in the 
following example: 

I IF|6TST|6ANDt!i2t6THEN|6'TRACE COMPLETED' Display the message if bit 14 of system 

variable TST is true. 

A mask value of I tests the status bit that is true when the trace module is running. A mask value of 2 
tests the status bit that is true when a trace operation has completed. A mask value of 4 tests the status 
bit that is true when an event and delay completion has occurred. 

5.11.7 STOP TRACE COMMAND. The Stop Trace command (THLT) stops the trace module, and 
returns the status in system variable TST. The syntax for the THLT command is as follows: 

?THLT; 
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When the trace module has been started and has not been stopped by the internal circuitry or by the 
emulator, the TH LT command stops the trace module. The command displays the trace module status 
(system variable TST). Since the status is read after the trace module is halted, only the even numbers 
in table 5-4 apply. The following is an example of the THLT command: 

? THLT; Stop the trace module. Status indicates 

>0002 that the trace is stopped, the trace 

operation has completed and the event 
and delay operation has not completed. 

5.11.8 READ LOW-ORDER TRACE MODULE MEMORY COMMAND. The Read Low-Order 
Trace Module Memory command (TTB) is a system function that reads the 16 low-order bits of the 
specified stored value. The syntax for the command is as follows: 

?TTB(<index>) 

The index operand may be any valid expression. When the value of the expression is a valid index to 
the trace memory, the command displays the value stored in the low-order 16 bits of the location 
corresponding to the index value. Two system variables contain the limits of valid index values. System 
variable TTBN contains the index value corresponding to the most recently stored value. System 
variable TTBO contains the index value corresponding to the oldest value stored. 

When the trace module is running, it stores a value in trace memory when the qualifiers have the 
specified values and a clock occurs. The trace module may be stopped internally when a specified 
number of values have been stored or when a specified number of events and a specified delay have 
occurred. In these cases, or when the operation is stopped by the emulator or by command before the 
event and delay have occurred or the trace operation has completed, the most recently stored value 
correspond to an index of zero. When the event and delay operation has completed before the trace 
module halts, the index value of zero corresponds to the value stored by the specified event, and values 
stored during the delay period (and during the time required by the emulator to complete execution of 
the current instruction) are accessed by positive index values. Values stored prior to the value 
corresponding to index are accessed by negative index values. Figure 5-2 shows an example of trace 
memory contents, assuming that the fourth value traced was the specified event, and that a delay of two 
was specified. The example also assumes that the completion signal stopped the trace; no additional 
delay occurred. The index of -3 corresponds to the first value traced and negative values denote 
successive values traced. The event value corresponds to index value 0. The values corresponding to 
indexes 1 and 2 were stored at delay counts. 

In the trace module, the delay count and a further delay while the currently executing instruction 
completes, can cause additional values to be stored. When the total delay causes 256 or more additional 
values to be stored, the value associated with the specified event is overlayed by another value. The 
index value is also misleading. This problem can be avoided by limiting the magnitude of the value 
placed in the delay register by a TEVT command, and entering TBRK and EBRK commands that 
cause the trace module to stop. 

When the trace module is connected in the emulator control and data mode, the 1 6 bits read by the TTB 
command are either memory data or memory addresses, as selected by a TTRC command prior to the 
operation. In the other two connection modes, the bits are signals to which the probe leads 
corresponding to the 16 low-order bits (D4 through D19) are connected. 
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INDEX 
-3 
-2 
-I 



FIRST VALUE STORED 



SECOND VALUE STORED 



THIRD VALUE STORED 



FOURTH VALUE STORED~EVENT 



FIRST VALUE STORED AFTER EVENT 



SECOND VALUE STORED AFTER EVENT 



(A)137457 



Figure 5-2. Trace Memory Contents After Trace 



When the target system uses a TMS 9980 microprocessor, each memory access transfers a single byte. 
Trace memory stores 16 data bits and four qualifier bits, when the trace module is connected in the 
emulator control and data mode. Figure 5-3 shows the contents of trace memory when data is traced 
and qualifier QO is masked off (not specified in the TTRC command). The first memory access after 
larting the emulator is one in which QO is true. Subsequent memory accesses show QO alternately false 
ind true. At each memory access during which QO is true, the most significant byte is the addressed 
byte and the least significant byte contains random data. At each memory access during which QO is 
false the least significant byte is the addressed byte, and the most significant byte is unaltered. The 
contents of trace memory when the trace is specified in this manner show the way in which the 8-bit 
accesses are combined in a 16-bit word, and also show that tracing with qualifier QO false selects only 
alternate memory accesses during which the word on the data bus coincides with the word as stored in 
target system memory. 

Alternatively, a TTB command and its operand may be used as a variable in an AM PL statement. The 
stored value corresponding to the value of the operand becomes the value of the command when used 
as a variable. 



The following are examples of TTB commands: 

? TTB (I?) 
>78E2 

? TTB (25) 
>FFFF 



? NUADD = TTB(0) + 10 



Display the low order 16 bits of the value 
stored as the specified event. 

Display the low order 16 bits of the value 
stored at the 25th delay count following 
the specified event. 

Assign a value to user symbol NUADD. 
The value is the sum of the value in the low 
order 16 bits of the value stored as the 
event plus 10. 
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BITS 12-19 



INDEX QO Ql Q2 Q3 BITS 4-11 

-3 
-2 
-1 



NOTE- BITS REPRESENTED BY X ARE BITS THAT MAY HAVE EITHER 
VAlIiE BYTES THROUGH 3 ARE FOUR CONSECUTIVE BYTES 
OF TARGET MEMORY, WITH BYTE CORRESPONDING TO ANY 
EVEN (WORD) ADDRESS. 



1 
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X 


BYTE 


XXXXXXXX 
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BYTE 


BYTE 1 
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BYTE 2 


XXXXXXXX 
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BYTE 2 


BYTE 3 
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Figure 5-3. Trace of Data Stored in Trace Module During Unqualified Trace of TMS 9980 

5.11.8.1 System Variable TTBO. System variable TTBO is set to the index value of the oldest value 
stored in memory by the trace module. TTBO may not be assigned a value by the user, but may be 
displayed when the trace module is not running. The value of TTBO is the smallest (most negative) 
value that may be used as an index in a TTB or TTBH command. When this value is greater than the 
value of system variable TTBN, no values have been stored and a TTB or TTBH command cannot be 
executed. The following is an example of a display statement to display TTBO: 



? TTBO 
>FF80 



Display the most negative valid index to 
trace memory. 



5.11.8.2 System Variable TTBN. System variable TTBN is set by AMPL software to the index value 
of the most recently stored value in trace memory. TTBN may not be assigned a value by the user, but 
may be displayed whenever the trace module is not running. The value of TTBN is the largest (most 
positive) value that may be used as an index in a TTB or TTBH command. When this value is less than 
the value of system variable TTBO, no values have been stored and a TTB or TTBH command cannot 
be executed. The following is an example of a display statement to display TTBN: 



]_ TTBN 
>005F 



Display the most positive valid index to 
trace memory. 



5.11.9 READ HIGH-ORDER TRACE MODULE MEMORY COMMAND. The Read High-Order 
Trace Module Memory command (TTBH) is a system function that reads the four high-order bits of 
the specified stored value. The syntax for the command is as follows: 

? TTBH(<index>) 
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The index operand may be any valid expression. When the value of the expression is a vahd index to 
the trace memory, the command displays the value of the four high-order bits in the location 
corresponding to the index value. The bits are displayed right-justified in a 16-bit word, zero-filled to 
the left. The limits of valid index values are the same as described for the TTB command. The four 
high-order bits accessed are stored by the trace module along with the 16 low-order bits accessed by a 
TTB command that specifies the same index. The description of index values in paragraph 5.11.8 
applies to the TTBH command also. 

An alternate form of the command displays a value of zero (false) or one (true), the result of comparing 
specified bits of the four high-order bits with specified values. The syntax for this form of the TTBH 
command is as follows: 



?TTBH(<index>,' 



n+i 1 p+l 1 p+i 1 

y-) iaqJ Ij-I dbinJ [I-IemuJ 



The index operand has the same form and Hmits as in the other form of the command. The second 
operand is a series of one to four keywords each preceded by a sign. The series denotes a value and a 
mask for comparison with the four high-order bits. When a keyword is preceded by a plus sign the 
value of the corresponding bit is one. When a keyword is preceded by a minus sign, the value for the 
corresponding bit is zero. The sign may be omitted preceding the first keyword; the plus sign applies. 
When a keyword is omitted, the bit is masked off, and is not used in the comparison. When the 
specified bits have the specified values, the command returns one. Otherwise, the command returns 
zero. The alternate keywords apply when the trace module is connected in the emulator control and 
data mode. 

Either form of the TTBH command may be used as a variable in an AM PL statement. 



The following are examples of TTBH commands: 

? TTBH (0) 
>000D 



<1 



1 TTBH (0,Q0+Q1-Q2):B1 



IF|6TTBH(0,EMU)t6THEN TTB(0) 



Display the high order four bits of the 
value stored as the specified event. 

Display the same value as the result of a 
comparison. 

Display the low order 16 bits of the value 
stored as the event when the event was also 
an emulator event (emulator control and 
data mode). 
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SECTION VI 
ERRORS AND RECOVERY 



6.1 INTRODUCTION 

Error messages are printed on the system console when errors are detected. This section hsts the 
error messages and methods of recovery from errors. 

6.2 ERROR MESSAGE FORMATS 

AMPL software provides two categories of error messages. The warning messages are displayed 
when conditions which do not necessarily require termination of the command are detected. The 
error messages are displayed when error conditions are detected. The following is an example of 
a warning message: 

*** WARNING 204 0000 0001 

EMULATOR TRACING WITH TRACE/ 
CONTROL MEMORY SELECTED 



The number 204 is the message number. The leftmost hexadecimal number is the contents of 
workspace register zero, and the second hexadecimal number is the contents of workspace register 
one. The error message on the next line identifies the warning as the result of an emulator trace 
operation while the trace operation while the trace memory is available to the target system. 

The contents of workspace registers zero and one are printed with all messages; in the case of 
the example message, only the most significant byte of workspace register zero is relevant. For 
an emulator DSR error, the DSR error code is in that byte, and it identifies the error as a device 
error; the emulator is unable to perform the operation required to read the target system 
registers (WP, PC, and ST). The user must refer to the operating system manual for explanations 
of DSR error codes other than the three listed in the message. 

The following is an example of an error message: 

*** ERROR 5 >9CC6 >27Q4 

I/O ERROR; UNABLE TO OPEN FILE 

The number 5 is the message number; the leftmost hexadecimal number is the contents of 
workspace register zero, and the second hexadecimal number is the contents of workspace 
register one. The error message identifies the error as an I/O error that occurs because the file 
cannot be opened. The only relevant information is the most significant byte of workspace 
register one, which contains the 1/0 error code (DSR error code) as listed in the operating 
system manual. The code in the example, 27i6, indicates that the file name is undefined. 

Some types qf errors display a symbol also, as follows: 



*** ERROR 103 TSTP =>AAA6 >^ 

SPECIFIED SYMBOL HAS NOT BEEN DEFINED 
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The number 103 is the message number, which is followed by the characters of a symbol, an 
equal sign, the contents of workspace register zero, and the contents of workspace register one. 
The error message on the next line identifies the error. The contents of the workspace registers 
are not relevant in this case. 

Only eight error messages are memory resident; these are error messages for errors that occur more 
frequently. The messages for errors 1, 5, 6, 7, 103, 113, 117, and 224 are memory resident and are 
printed whenever these errors occur. Messages for the remainder of the errors are on an error message 
file; when this file is available messages are printed for all errors. When this file is not available only the 
first line (containing the error number, optionally a symbol, and the contents of workspace registers 
zero and one) is printed when errors other than those for which the messages are resident occur. The 
circumstances under which the error message file is available differ for different operating systems. 

Under TX990 the error message file is on the system diskette. When the system diskette is on floppy 
disk unit 1 (lefthand unit) the error message file is available. If the system diskette is on another floppy 
disk unit, or if the error file has been deleted to provide more space on the system diskette for other 
files, the error message file is not available. 

Under DXIO, the error message file is installed under the pathname .S$SYSLIB.AMPL$ET1. When 
this is done, error messages are available unless the error message file has been deleted or its pathname 
changed, or the disk volume has been unloaded. 

During initialization of AM PL software, immediately after loading the software, the error message file 
is opened, if the file is not available, message number 5, UNABLE TO OPEN FILE, is displayed. 
When errors for which error messages are not memory-resident occur, the user will have to look up the 
error message from table 6-1. 

If the user should remove the system diskette or unload the disk volume that contains the error message 
file, and an error occurs (other than those for which the messages are memory-resident), the software 
prints message?, I/O ERROR; READ ERROR. Any further errors are identified as if the error file 
had not been opened. 

Table 6-1 Hsts the message numbers and their significance, and the possible ways of recovering 
from the error. It also indicates which messages display a symbol, and which register contains 
relevant information. Some message numbers may appear in either a warning message or an error 
message, depending on the severity of the condidon in the context within which it is detected. 
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SECTION VII 
EXAMPLES 

7.1 INTRODUCTION ^ ^ . ^ u 
This section contains examples of the use of AMPL statements and commands to debug a 
program The examples all relate to an example program, showing how commands may be used 
to load the program, to determine that the instructions in the program are executed in the 
proper sequence, and that the results are correct. The examples and apphcations of an AMPL 
system to the debugging of a program are not intended to be exhaustive, but to be typical ot 
what the user can do. 

7.2 EXAMPLE PROGRAM ^, , • , . 

The example program consists of a driver and a sine-cosine subroutme. The driver includes a set 
of values of angles, buffers for results, and a loop of instructions to call the subroutme to 
compute the sine and cosine for each angle, and store the results. The subroutine consists of a 
set of instructions to initialize the registers for the computation, and a loop of mstructions to 
perform the computation. After executing the loop 12 times, the subroutine returns control to 
the driver program. The subroutine uses a table of 12 arctangents in the computations. 

Assemble the source code either with TXMIRA under TXDS or with SDSMAC under DXIO, 
following the operating instructions in the appropriate system documentation. Figure 7-1 shows the 
source listing printed when the program was assembled by TXMIRA. 

1. Perform steps 1 through 5 of the procedure in paragraph 5.2.2 to load TXDS and to 
start execution of the operating system. 

2. Enter an exclamation point (!). TXDS should request a program name. Request 
TXMIRA as follows: 

PROGRAM: :TXMIRA/SYS 

3. Define the input (source file) as follows, using the file name assigned when the file was 
written : 

INPUT: :SINTST/TEM 

4. Enter the device name of the device on which the listing is to be printed, as follows: 

OUTPUT: .LOG 

5. Enter the desired assembler options, as follows: 

OPTIONS: LS 

6. TXDS prints the following messages as it loads and executes TXMIRA: 

TXMIRA 936227 ** 

When TXMIRA completes the assembly, control returns to TXDS, which requests another 
program. 
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INTST TXMIRft y36£'£'7 ♦♦ PRGE 0001 

01* 

OOOe ♦ DRIVER FDR SINE - CUSINE SUBROUTINE 

0003 ♦ 

0004 IDT SINTST- 

0005 0000 RO EQU 

0006 00 01 Rl EQU 1 

0007 00 02 R£ EQU £ 

0008 00 03 R3 EQU 3 
00 09 04 R4 EQU 4 

0010 00 05 R5 EQU 5 

0011 00 06 R6 EQU 6 

0012 00 09 R9 EQU 9 
1 3 OR RIO E QU 1 

0014 00 OB Rll EQU 11 

0015 00 I...ISP1 BSS 18 REGISTERS 0-8 

0016 001£ OOOE DRTfl 14 REGISTER 9 - LDDP COUNT 

0017 0014 00 DflTFI REGISTER 10 - LDCIP COUNTER 

0018 0016 ESS 10 REGISTERS 11-15 

0019 0£0 0100 ANGLE DFlTfl >100 1 DEGREE 
00£0 0££ 02 DRTR >£00 £ DEGREES 
0£1 0£4 04 DATA >4 4 DEGREES 
0££ 0026 0800 DATA >800 8 DEGREES 

0023 0028 1000 DATA >1000 16 DEGREES 

0024 002A IE 00 DATA >1E00 30 DEGREES 

0025 002C 3C00 DATA >3C00 60 DEGREES 

026 02E SINE ESS 14 SINE BUFFER 

027 no --If: CDS BSS 14 COSINE KJFFP£R 

0028 04A 02E0 BEGIN LWPI WSPl LOAD WORKSPACE POINTER 

04C 0000' 
029 nn4E 04r:A CLR RIO FESE"^( COUNTER 

003 050 C82A CDMP MDV JANGLE <R1 0> j *INP MD'VE ANGLE TO CALLING SEQUENCE 

052 00£0' 

054 005A' 
031 0056 06 A EL S'SINCDS BRANCH TO SUBROUTINE 

058 0074'' 

03£ 005A 00 00 INP DATA ANGLE 

0033 05C 00 00 SIN DATA SINE 

34 OOISE 00 00 CDSN DATA COSINE 

0035 06 CAAO MDV ;iiSIN» »SINE -^Rl 0> MDVE SINE TO BUFFER 

062 005C'' 

064 002E'' 
036 066 CAAO MDV *CDSNj SCDS CRl O) MDVE COSINE TO BUFFER 

068 05E' 

06 A 003C' 

06C 05CA INCT RIO INCREMENT INDEX 

OOAE 824A C R10?R9 FINISHED? 

07 llEF JLT CDMP CONTINUE 



0:r!7 
038 
039 



04 072 0340 IDLE THAT'S ALL! 

(A)1 36544 (\/Z) 



Figure 7-1. Example Program Listing (Sheet 1 of 3) 
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INTST 



TXMIRft 936227 ♦♦ 



PAGE 00 OS 



042 
04 3 
0044 
045 
004>:. 
047 
004S 
04'? 
05 
051 
0052 
053 
054 
0055 
005":. 
0057 
005S 
059 
06 
06 1 

0062 
0063 
0064 
065 
066 
067 
0063 
0069 

07 
071 
072 
0073 

0074 
0075 
0076 
0077 
075! 
0079 
03 

OS 1 
0032 
0033 
0034 



074 
076 
073 
007R 
007C 
007E 
03 
0032 
034 
036 
0038 
03R 
03C 
03E 
090 
092 
094 
0096 
093 
091=1 
009C 
09E 
OOftO 
0A2 
0R4 
0R6 
Oft3 
OflR 
ORC 
ORE 
OOBO 
00l!2 



04C0 

C07E 

05 1 

04C2 

0203 

4riBA 

04C4 

C 1 43 

04 C 6 

C041 

1 1 05 

6035 

R0C4 

6066 

00E4' 

1 04 

R035 

60C4 

R066 

00E4' 

0530 

05C6 

CI 02 

03 04 

CI 43 

03 05 

0280 

OOOC 

UEC 

CEC2 

CEC3 

045B 



♦ 



IIMCDS SUERDUTINE 

;IMCDS COMPUTES THE SINE RND CDSINE DF RN RM'5LE 



CRLLING SEQUENCE: 
BL JSINCDS 
DRTR RNGLE 
DRTR 
DRTR 



IN IpEGREES ♦ 256 
SINE RETURNED HERE 
COSINE RETURNED HERE 



THE SUBROUTINE RLTERS THE CONTENTS OF RO 
THE OUTPUTS RRE SIGNED BINRRY FRRCTIDNS 



R6 RND RU 



;:INCOS CLR RO 

NOV ♦P11+«R1 

NEG Rl 

CLR R£ 

LI R3»>4DER 



CLR R4 

MOV R3jR5 

CLR R6 

MOV RljRl 

JLT NEG 

S R5»R2 

R R4.R3 

S :;'RTflN'::R6> »R1 



SER 



NEG 



COM 



JMP COM 

R R5»R2 

S R4jR3 

R .iiRTRN(:R6:> »R1 



I NC 

INCT 

MOV 

SRR 

MOV 

SRR 

CI 



RO 

R6 

R2»R4 

R4jR0 

R31.R5 

R5.R0 

R » 1 2 



JLT SER 

MOV R2j*P11+ 

MOV R3.*R11+ 

RT RETURN 



INITIRLI2E SHIFT COUNT 
GET RNGLE 
NEGRTE RNGLE 
INITIRLIZE SINE 
INITIRLIZE COSINE 

INITIRLIZE ilNE ONE 
INITIRLIZE COSINE ONE 
INITIRLIZE INDEX REGISTER 
STRRT SERIES. TEST SIGN 
JUMP IF NEGRTIVE 
SUBTRRCT CDSINE ONE FROM SINE 
RDD SINE ONE TO CDSINE 
SUBTRRCT RRCTRNGENT FROM RNGLSi 

ERRNCH TO COMMON CDDE 
RDD COSINE ONE TO SINE 
SUETRRCT SINE ONE FROM CDSINE 
RDD RRCTRNGENT TO RNGLE 

INCREMENT SHIFT COUNT 
INCREMENT INDEX REGISTER 
MOVE SINE TD SINE ONE 
DIVIDE SINE ONE BY £**P0 
MOVE COSINE TD COSINE ONE 
DIVIDE COSINE ONE BY 2**R0 
SHIFT COUNT LESS THRN 12? 

YES - CONTINUE 

MDVE SINE TD CRLL SEQUENCE 

MDVE CDSINE TD CRLL SEQUENCE 



Figure 7-1. Example Program Listing (Sheet 2 of 3) 
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SINTST 


TXMIPfl 


M 


36££7 ♦♦ 










PRGE 


0003 


0084- 




♦ 


RRCTflNGENTS 












0085 0OE4 


ED 00 


FiTfiN 


DflTfi 


>£D00 












036 00B6 


lfl90 






DftTft 


>lfl90 












087 00B8 


0E09 






DflTfl 


>E09 












088 OOBfl 


0720 






DfiTH 


>7£0 












0089 OOBC 


0394 






DRTR 


>394 












09 OOBE 


OlCFl 






DRTR 


>1CR 












0091 OOCO 


00E5 






DRTR 


>E5 












009S 00C£ 


0073 






DRTfl 


>73 












009 3 0C4 


0039 






DRTR 


>39 












0094 0C6 


00 in 






DRTR 


>1D 












0095 00C8 


OOOE 






DRTR 


>E 












0096 OOCfl 


0007 






DRTR 


>7 












0097 








END 


EE6IN 












R RNGLE 


OOSO 




R 


RTRN 


00E4 


R 


BEGIN 


:i04R 


R CDN 


009C 


R CDMP 


0050 




R 


CDS 


003C 


R 


CDSN 


:i05E 


R INP 


05R 


R NE6 


0094 






RO 


00 




Rl 


JOOl 


RIO 


OR 


Rll 


OOOE 






R£ 


00 0£ 




R3 


J003 


R4 


0004 


R5 


00 05 






R6 


06 




R9 


:ioo9 


R SER 


0086 


R SIN 


005C 




R 


SI NCOS 


0074 


R 


SINE 


3 0£E 


R WSPl 





000 ERROR 


s 




















(A)1 36544 (3/3) 





















Figure 7-1. Example Program Listing (Sheet 3 of 3) 



7.3 LOADING THE EXAMPLE PROGRAM 

Prior to loading the example program, the AM PL program must be loaded and started. Perform the 
steps in the appropriate paragraph of Section V (depending on the operating system). 

Before loading the program, accessing system variables ETM or EUM, or accessing target memory, 
the emulator must be initialized. The first command to be entered is an HINT command, as in the 
following example: 



HINT ('EMU') 



Initialize Emulator EMU. 



The example uses the device name EMU which applies to a TX990 system supplied by Texas 
Instruments. Substitute the correct device name for other operating systems; e.g., EMOl for DXIO. 

The AMPL program loads programs into target system memory by executing a LOAD command. 
Target system memory addresses through 1 FFFi6 may be mapped either into emulator memory or 
target system memory. Prior to entering a LOAD command the user should display the system 
variables that control mapping, as follows: 



?EUM:B1 



<1 
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The display of system variable EUM shows that it has been set to one, mapping address through 
1 FFF16 into the user memory of the emulator. It is assumed that the example program will be stored in 
PROM, and should be tested in emulator memory. The value of one, then, is the desired value. Displ^ 
the other variable as follows: 

_ ?ETM:B1 
<i 

The display of system variable ETM shows that it has been set to one, mapping addresses FEOO16 
through FFFF,6 (3E00i6 through 3FFF,6 in a target system using the TMS 9980) into the trace 
memory of the emulator. Since the example program does not occupy this area of memory, either value 
of ETM would be satisfactory. If it were necessary to map memory differently, the system vanables 
EUM and ETM would be assigned the correct values by entering assign statements. The user should 
verify the mapping of memory before beginning the debug session. 

Next, enter the LOAD command to load the example program, as follows: 

?.LOAD('DSC:SINTST/OBJ' ,>100) 

The first operand consists of the device name of the device on which the object file resides, and the file 
name. The example shown applies to TX990; a DX 10 pathname would be used in a DXIO system. The 
second operand causes the AMPL program to load the example program at address 100,6. If the 
operand is omitted, the program is loaded at address A0,6. The value of IOO16 is chosen to simplify the 
computation of target memory addresses from the relative addresses shown in the assembly listing. In 
many cases the load address may not be chosen arbitrarily, but is determined when available memory is 
allocated for target system requirements. 

7.4 INITIAL DEBUGGING 

To check that the program is loaded as intended, and to verify a constant in the subroutine 
enter the following command: 

?_(a(>7E+>100):H 
>4DBA 

Referring to the assembly listing on sheet 2 of figure 7-1, notice that the fifth instruction in 
subroutine SINCOS is an LI instruction that places an initial value in workspace register 3. The 
preceding command displays the constant (at location 7Ei6 relative to the first location ot the 
program) as a hexadecimal value. The result is the correct value, venfying both the loading 
of the program and the constant on which the computations depend. 
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The subroutine also uses a table of arctangent values in the computation. The following example 
uses a command statement to verify these values: 



7 


BEGIN 




1? 


ATAN 


= >B4+>lj2fjZf; 


1? 


CNT 


= 0; 


1? 


WHILE)6CNT|!5LT|«24|i5DO 


1? 




BEGIN 


2? 




@(ATAN + CNT):HXXXXX; 


2? 




@(ATAN + CNT + 2):HXXXXX; 


2? 




@(ATAN + CNT + 4):HN: 


2? 




CNT = CNT + 6 


2? 




END 


1? 


END 




>2D^ef 




>1A90 >0E09 


>0720 




>0394 >01CA 


>JJ0E5 




>0073 >0039 


>J301D 




>000E >0007 



The example uses an assign statement to assign the user symbol ATAN to the address of the 
table, and another assign statement to clear the user variable CNT. Then, using a WHILE 
statement that contains a compound statement, the examples prints the 12 constants as decimal 
values, three on a hne. The values are correct, and verify that the data to be used in the 
computations is correct. 

7.5 USING THE EMULATOR 

In order to execute the program, an ERUN command must be entered. However, the user should 
set up a condition or conditions for stopping the emulation before executing the ERUN 
command. The EBRK command defines a breakpoint and specifies whether the breakpoint 
occurs when an event occurs, when a trace operation completes, or at either an event or a 
completion of a trace operation. The EEVT command defines an event as either the result of a 
comparison defined by an ECMP command, or an external event. The ETRC command defines a 
trace operafion. These commands can be used in various combinafions to stop emulation at a 
point that allows the user to verify whether the portion of the program being tested has 
executed properly. 

Referring to sheet 3 of figure 7-1, the END directive of the source program defines BEGIN as the 
entry point. The LOAD command should have placed the address corresponding to label BEGIN 
in the target system program counter. If the user sets up a trace of five instructions and a 
program count comparison of 14Ei6, the emulator should execute two instructions. However, 
should the program contain an error that causes a transfer of control that prevents the execution 
of the specified instruction, the trace operation would stop emulation after execution of five 
instructions (TMS 9900), and examination of trace memory contents would show which instructions 
had been executed. The following example shows the necessary commands; 

?ETM = Target memory addresses should not be 

mapped into trace memory while tracing 
is being done. 

?EEVT(INT) Event is internal. 

?^ECMP(IAQ,>14E) Compare program counter to I4E|6. 
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iETRC(IAq,6,INT) JjMS 9^). """"" '"""'" ™"" 

1^'^^'^' Start emulation. 

In a TMS 9980 system, the same commands could be used, but if the comparison did not occur before 
the trace completion signal stopped the emulator, six addresses would have been stored. These 
addresses would be the addreses of the bytes that contain three instructions. To trace five instructions 
as in the example, the ETRC command for a TMS 9980 system would be: 

?ETRC(IAQ,10,INT) 

The emulator should begin emulation at the address in the target system program counter and 
halt emulation and request an entry by printing a question mark. The user enters a command to 
determine where emulation was halted, as in the following example: 

1 DR; 

R£( = >m0 R8 = >mm PC = >j3150 / >C82A MOV @>)?120(R10) .@>j2fl5A 

Rl = >0i^00 R9 = >000E WP = >0W 

R2 = >0000 R1J0 = >0000 ST = >2200 

R3 = >0000 Rll = >0000 

R4 = >0000 R12 = >00g0 

R5 = >g000 R13 = >000g 

R6 = >0000 R14 = >0000 

R7 = >0000 R15 = >00t^H 

The contents of PC is 150i6, indicating that the emulator was halted by the breakpoint at 
14Ei6, and that the program has executed correctly to this point. The contents of WP (100i6) 
show that the LWPI instruction executed correctly, and the contents of R10 show that the CLR 
instruction executed. Contents of other registers and workspace registers may differ from those 
shown in the example. 

7.6 TRACING WITH THE EMULATOR 

The user could set up another breakpoint comparison, or another trace, at this point. However, 
the user could also execute another ERUN command, using the same breakpoint comparison 
already set up, and the same trace parameters. The comparison should not occur again, because 
control should not return to this point in the program unless it is restarted. Tracing five 
instructions should cause the emulation to halt following the third instruction of subroutine 
SINCOS. The user enters an ERUN command, as follows: 

?ERUN ; 

The command starts emulation, which halts either as a result of the specified comparison or after 
tracing five instruction addresses. The user displays the PC to determine which breakpoint was 
effective, as follows: 

IPC 

PC = >017A 
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This value in the PC indicates that the emulator was halted when five instructions had been 
traced. The user may enter the following to determine which instructions were traced: 



?. N = ETBO 

]_ WHILE*5NtiLE|ZlETBN|6DO0BEGIN 
1?. ETB(N):HN 
12 N = N + 1 
1? END 



Set N to index of oldest value traced. 
Perform compound statement until N is 
equal to index of newest value traced. 
The compound statement displays the 
indexed value and increments the index. 



>0150 
>0156 

>FI76 

The results of the preceding example are the addresses of the five instructions emulated 
following entry of the ERUN command. 

In a TMS 9980 system, using the proper ETRC command, ten addresses would be stored as follows: 

>0150 
>0151 
>0156 
>0157 
>0174 
>0175 
>0176 
>0177 
>0178 
>0179 

The correct instructions were emulated. The user could display register contents to verify the accuracy 
of the computation, as follows: 



R£( = > 



I Rl 

Rl = >FF£ija 



The zero in RO verifies operation of the CLR instruction at location 0174i6. The result in Rl 
verifies that the MOV instruction at location 15(?i6, the MOV instruction at location 176,6, and 
the NEG instruction at location 178,6 operated correctly. 

7.7 MONITORING PROGRAM EXECUTION 

The user may then enter a series of commands to emulate the loop of instructions in the 
SINCOS subroutine and display register contents showing the results. The commands repeat the 
operation for each iteration of the instructions, allowing the user to verify the steps of the 
computation. First, the EBRK command sliould be entered as follows: 



I ERBK (EVT) 



Define breakpoint to occur on compare 
only. 
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Change the comparison by entering an ECMP command as follows: 

]_ ECMP (IAQ,>1A8) Breakpoint at CI instruction at end of 

loop. 

The breakpoint has been altered so that completion of the defined trace operation does not halt 
the emulator. Tracing may still be done, however, and tracing of addresses yields helpful 
information. Change the trace definition as follows: 

]_ ETRC ( IAQ,256) Change the trace count to 256. 

Enter a REPEAT statement to emulate the instructions repeatedly, as follows: 

]_ REPEATJiBEGIN Execute a compound statement repeat- 

1? ERUN; edly until target system workspace regis- 

1? R0 ter (? contains 12. The compound state- 

1? Rl ment starts emulation and displays target 

1? R2 system workspace contents when a 

1? R3:HN breakpoint stops emulation. 

TT R4 
1?. R5 
il R6:HN 
1?. END|iJUNTIL|4RO»5EQt512 

The statement should produce 12 sets of contents of the seven registers used in the computation. 
The following shows the portion of the results displayed during the first iteration of the loop: 

R0 = >0£l01 Rl = >2Cm R2 = >4DBA R3 = >4DBA 
R4 = >26DD R5 = >26DD R6 = >mW 

7.8 DISPLAYING TRACED ADDRESSES 

Before analyzing the data in the registers, the user may wish to display the traced addresses. If the target 
system has correctly executed the program in a TMS 9900 system, the trace should consist of 14 
addresses stored during the last iteration, following execution of the ERUN command. If the program 
has not been correct, there could be as many as 256 addresses stored. These would be the addresses 
of the last 256 instructions emulated. The following is an example of commands to display trace 
memory contents: 

?N = ETBO Set user variable N to the index of the 

oldest value traced. 
?_ REPEAT0BEGIN Display stored values until the index 

1?. ETB(N):HN; equals zero. 

11 N = N + 1 
1? END UNTIL N GE J0 
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>01AC 
^Il86 
>Fl88 
>018A 
>018C 
>018E 
>gl92" 
>019C 
>019E 
>glA0 

>01A6 
>01A8 



In a TMS 9980 system, the trace consists of 28 addresses if the target system has correctly executed the 
program; there could otherwise be as many as 256 addresses stored. These addresses would be the 
addresses of both bytes of the last 128 instructions emulated. The stored addresses for a correctly 
executing system are: 

>01AC 
>01AD 
>0186 



>0187 

>0188 

>0189 

>018A 

>018B 

>0I8C 

>0I8D 

>018E 

>018F 

>0192 

>0193 

>0I9C 

>0I9D 

>019E 

>019F 

>01A0 

>01A1 

>01A2 

>01A3 

>01A4 

>01A5 

>01A6 

>01A7 

>01A8 

>01A9 
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The display of addresses in the preceding example shows that the loop of instructions was 
executed in the proper order. The user may analyze the workspace register contents previously 
displayed and determine that the computation is correct. The first instruction to be executed 
when an ERUN command is entered is a JLT instruction. The user may display the status 
register contents as follows: 

? ST 

f\ = >3200 

Status register bits 2, 3, and 6 are set to one, indicating that the Equal, Carry, and XOP bits 
have been set. Bits and 1 equal to zero and bit 2 equal to one indicate that the result of the 
comparison in the last instruction emulated is correct, and the MOV instruction at address 
lAEie should be executed following the JLT instruction when an ERUN command is entered. 

7.9 CHECKING PROGRAM RESULTS 

The next breakpoint should allow the user to verify proper exit from the subroutine and storing 
of the sine and cosine values computed. The user may enter another ECMP command and an 
ERUN command as follows: 

? ECMP (-DBIN,>13C) Compare the addresses of write opera- 

~ tions to 13Ci6. 

? ERUN; Resume emulation. 

The breakpoint should occur following execution of the MOV instruction at location I6616. 
When the AMPL program requests another command, the user may verify the point at which 
emulation halted by displaying the PC, as follows: 

I PC 

PC = >016C 

The PC contents indicate that the instructions were executed in the proper sequence. If the 
emulation had halted at some other point, the traced addresses could be examined to determine 
what happened. 

At this point the sine and cosine of 1° should have been stored in locations SINE and COS of 
the driver program. The values are signed binary fractions, and are not directly convertible to 
decimal fraction values in trigonometric tables. The values may be displayed as decimal integers, 
as follows: 

2@>12E:DN Display contents of address 12Ei6 

570 (SINE) in decimal format. 

?_@>13C:DN Display contents of address 13C,6 

32761 (COS) in decimal format. 
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Divide these values by 32.768 to obtain decimal fraction equivalents. The computations of 
subroutine SINCOS for a single value are valid. The user may set the breakpoint to another 
value, emulate the subroutine for each angular value, and display the answers, as follows: 



?ECMP (ADDR,>172) 



?ERUN; 



Set breakpoint to compare memory 
addresses to 172] g. 

Start emulator. 



IPC 

PC = >£ll74 



Verify breakpoint. 



]_ PROC|iiSCDUMP(0,l)J5BEGIN 

11 'ANGLE SINE COSINE'; 

11 NL; 

11 LOCIiil = £1; 

11 WHILE|i5LOC01|!5LE012t«DO 

11 BEGIN 

21 (a(>120 + LOC|!51)/256:DXi 

21 (a(>12E + LOC|iSl):DXXX; 

21 (3(>13C + L0C|i51):DN; 

21 L0CI61 = LOC01 + 2 

21 END 

1? END 



Define procedure to display results in 
tabular format. 



ISCDUMP; 
ANGLE 



SINE 



1 


57£) 


2 


1144 


4 


2294 


8 


4450 


16 


9011 


M 


16388 


60 


28376 



COSINE 
32761 
32747 
32689 
32448 
31504 
28367 
16388 



Execute procedure. 
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When the values in the SINE and COSINE columns are divided by 32,768, the results are the 
more familiar decimal fraction equivalents. The user may enter new values for angles and repeat 
the test, as follows: 



2.>12)2f:H?:H 

>0120 / >J0ief0 =? = >2C00 

>0120 / >2C00 =? 

>0122 / >tim =? = >160jel 

>0122 / >160£l =? 

>0124 / >0400 =? = >BJ30 

>0124 / >0B00 =? 

>0126 / >0800 =? = >5900 



>0126 / >5900 =? 
>0128 / >1000 =? 
>0128 / >0F00 =? 



0Fef0 



012A / >1E00 =? = 0700 
>012A / >0700 =? 
>012C / >3C00 =? = £(30 



>012C / >0300 =? 

2PC =>14A 

2ERUN; 

7SCDUMP; 



Display and modify first angle. 

Display and modify second angle. 
Display and modify third angle. 
Display and modify fourth angle. 
Display and modify fifth angle. 
Display and modify sixth angle. 
Display and modify seventh angle. 



Set PC to start of program. 
Emulate program with new data. 
Display results. 



At this point, the subroutine computations have been verified using 14 different angle values. 
The user may verify the subroutine more thoroughly by computing additional sines and cosines, 
or may accept the program as having been tested adequately. 

7.10 USING THE TRACE MODULE 

Had the sines and cosines not been correctly calculated, the user may want to execute 
subroutine SINCOS tracing all memory addresses and data. Analysis of traced addresses and the 
data in those addresses should identify the error in the calculations. Assuming that the trace 
module is connected in the emulator control and data mode, the following commands would 
trace the SINCOS subroutine: 



?TINT('TRA') 



?TBRK(OFF.OFF) 



^TTRC(DATA+OFF.256.EXT,OFF) 



■^TRUN: 



?EBRK(EVT,SELF) 



Initialize trace module (TX990: TROI for 
DXIO). 

Turn off trace module breakpoint 
conditions and action. Trace module is to 
operate under emulator control. 

Trace 256 words of memory data, 
following the clock from the emulator, 
with the latch mode off. 

Trace module starts when ERUN 
command is executed. 

Define breakpoint to stop the 
microprocessor when an event occurs. 



7-13 



Digital Systems Division 




946244-9701 



_?EEVT{INT) Define an event as a signal from the internal 

comparison circuitry. 

2ECMP(IAQ,>1A8) Compare instruction addresses to 1A8,6. A 

breakpoint occurs when the instruction that 
closes the loop in subroutine SINCOS is exe- 
cuted. 

?.ETRC(ADDR,256,EXT) Trace 256 addresses, clocked by the target 

system clock enabled by a signal from the 
trace module. 

IPC = >14A Start execution at location BEGIN of driver 

routine. 

?_ERUN ; Start the microprocessor. 

The commands in the example trace all memory accesses in a TMS 9900 system, storing the memory 
address in the emulator trace memory, and the memory data in the trace module memory. The trace 
module memory contains signals lAQ, DBIN, and EMU in the high-order bits. The addresses were 
stored in the emulator simultaneously with the storage of data in the trace module; however, the 
indexes are not necessarily equal. The address stored at the index in system variable ETBO 
corresponds to the data stored at the index in system variable TTBO, and both addresses and data are 
stored sequentially following these indexes. 

In a TMS 9980 system, the commands listed for the TMS 9900 system could be used, but would trace 
addresses and data that serve no purpose. By changing the TTRC command as follows, the trace of a 
TMS 9980 system is similar to that of a TMS 9900 system: 

J?TTRC( D ATA-Q0,256,EXT.OFF) Trace 256 words of memory data, storing 

the contents of the data bus only when the 
complete memory word is on the bus. 

The ETRC command specifies EXT, which causes the emulator trace clock to be enabled by the trace 
module trace clock, synchronizing the trace in the emulator to that in the trace module. The addresses 
traced in the emulator are odd addresses, each of which is one greater than the address of the word 
stored in the trace module memory. 

To determine the cause of erroneous results the user is mainly concerned with memory write 
accesses. The data stored in the trace module memory is the data written, and represents the 
results of the computations. The following example shows commands to print the emulator trace 
index, the address, and the data for each write access stored in the trace memories: 

?_N = ETBO Set variable N to oldest index for emulator 

trace memory. 

?_M = TTBO Set variable M to oldest index for trace 

module memory. 
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IWHILE NKLEtiOI^DOKBEGIN 
11 IF TTBH (M,-DBIN)0THEN^BEGIN 
2]_ N : DXX 

2? ETB(N):HXX 

2?. TTB (M):HN 

2]_ END 

1?. M = M+1 
1?. N = N+1 
llEND 

Examining the results of executing these commands should identify the error in the calculations. 

The commands in the preceding example may be used in a TMS 9980 system, and will display the 
addresses of the least significant bytes of the words displayed. By changing the statement on the fourth 
line (the one that displays the address) the user may display the same information as on a TMS 9900 
system. The statement may be changed as follows: 

2? (ETB(N) - 1):HXX 
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APPENDIX A 
TX990 SYSTEM GENERATION 

Texas Instruments supplies three versions of the TX990 operating system with the AMPLsystem. One 
of these versions uses the 913 Video Display Terminal (VDT) as the system console, another uses the 
733 AS R Electronic Data Terminal as the system console, and the third uses the 9 1 1 V DT as the system 
console. The user may wish to generate a TX990 operating system to support the AM PL system for 
various reasons. Some reasons for generating a system are as follows: 

• To provide more working storage in memory by ehminating support of devices that are not 
required. 

• To include the Operator Command Package, which provides operator interface with 
TX990. 

• To include support of a device (or devices) not supported by a standard TX990 system. 
Generating a system requires the following: 

• The TX990 parts diskette (part number 937803-2601) 

• AM PL system diskette (part number 937745-0007) 

• One of the following TXDS system diskettes: 

— For 911 VDT System Console (part number 937803-2605) 

— For 913 VDT System Console (part number 937803-2602) 

— For 733 ASR System Console (part number 937803-2603) 

• A scratch diskette on which the newly generated system is stored. 

In the following system generation procedures, the characters output by the system are underlined 
when both output and user input are shown. Commands are preceded by asterisks (*). 

The procedures include those for executing the following utility programs: 

• SYSUTL — Initialize time and date. 
TXCCAT — Copy object code of TXDS control program to the TX990 parts diskette. 
INITDSC — Initialize new system diskette. 
GENTX — To generate source code for TASKDF and TXDATA modules of system. 



• 



• 
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• OBJMGR - To select and copy modules required for new system to file TXPART/OBJ 
for input to TXLINK. 

• TXMIRA - To assemble modules TASKDF and TXDATA. 

• TXLINK - To link modules TASKDF, TXDATA, and those copied to TXPART/OBJ 
to form new system on file NEWSYS/SYS. 

• SYSUTL - To copy system loader to the new system diskette, and to designate the 
newly linked system as the current system. 

GENTX is an interactive program that accepts system parameters and device designations and 
generates source code for the system data modules TASKDF and TXDATA. In the portion of 
the procedure that apphes to GENTX, default values apply when no value (carriage return only) 
is entered. Refer to the Model 990 Computer TX990 Operating System Programmer's Guide for 
the default values and for complete system generation information. In the portion of the 
procedure that applies to defining devices, omit the definition of any devices that are not to be 
supported by the new system. All device names are completely arbitrary and may be changed as 
desired. 

To generate a new TX990 system, perform the following steps: 

1. Place the TX990 parts diskette in the right hand floppy disc unit, and the TXDS 
system diskette in the left hand unit. Place both units in ready. 

2. Press the HALT/SIE switch on the programmer panel of the computer. 

3. Press the RESET switch on the same panel. 

4. Press the LOAD switch on the same panel. 

5. The computer loads the system and prints a message similar to the following: 

TX990 SYSTEM RELEASE 2.2 

MEMORY SIZE(WORDS): 24576 AVAILABLE: 16749 

6. Enter an exclamation point (!) at the keyboard of the system console. The computer 
prints the following: 

TXDS 936215 ** 1/0 £J: 

PROGRAM: 

7. Enter the following information to execute utility SYSUTL to initialize the time and 
date. Terminate each line with a carriage return. The example shows entering data 
corresponding to 2:15 PM April 1, 1977. 

PROGRAM: :SYSUTL/SYS 
INPUT: 



OUTPUT: 



OPTIONS: 10,1977,4,1,14,15. 
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8. SYSUTL executes the command, printing the following message, and returning control 
to TXDS: 

TX990 SYSTEM UTILITY 937544** 
14:15:0J0 APR 1, 1977 

9. Enter the following information to execute utility TXCCAT to copy object code of 
the TXDS control program to the TX990 parts diskette. 

PROGRAM: :TXCCAT/SYS 

INPUT: :CNTROL/OBO 

OUTPUT: DSC2:CNTR0L/0BJ 
OPTIONS: *N0 OPTIONS 

10. Remove the TXDS system diskette from the left hand floppy disc unit, and place the 
scratch diskette on which the new system is to be written in the left hand unit. 

11. Enter the following information to execute utility INITDSC to initialize the new 
system diskette: 

PROGRAM: :INITDSC/SYS* 

TX990 DISC INITIALIZATION 937545 ** 

DISC NAME? DSC 
DISC I.D.? TXDS SYSTEM DISC 
Ok to £f^SE DISC ?? Y OR N Y 
CHECKING DSC 
INltlALlMlON COMPLETE 

12. Enter the following information to execute utility GENTX to generate source code for 
system modules TASKDF and TXDATA: 

PROGRAM: :GENTX/SYS* 

13. GENTX requests parameters as follows. Enter the values shown. Where no value is 
shown, the default applies. A carriage return terminates each Une. A value other than 
the default may be entered if required. 

TX99£I SYSTEM GENERATION 945673 *C 

MEMORY AVAILABLE - 20gg 

LINE FREQ. - 

TIME SLICE - 

pT WT. FACTOR - 

PL 1 WT. FACTOR - 

PL 2 WT. FACTOR - 

PL 3 WT. FACTOR - 

COMMON SIZE - 170 

# OF EXP CHASSIS - 

CHASSIS - 

DEV NAME - LOG 
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14. Define the system console. When the system console is a 913 VDT, perform this step, 
and skip to step 17. 



DEV TYPE - V913 
STATION # - 1 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 



TIME-OUT COUNT 



15. When the system console is a 91 1 Video Display Terminal, perform this step and skip to 
step 17. 

DEV TYPE - V9n 



STATION # - 1 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 

16. When the system console is a 733 ASR Data Terminal, perform this step. 

DEV TYPE - ASR 

LEFT CASS/PTP NAME - CSl 

RIGHT CASS/PTR NAME - CS2 

CRU BASE ADDR - 

ACCESS MODE - 

INT LEVEL - 

TIME-OUT COUNT - 

17. When one or more 913 VDTs other than the system console is required, enter an 
appropriate device name and the information requested in step 14 for each. When one 
or more 911 VDTs other than the system console is required, enter an appropriate 
device name and the information requested in step 15 for each. When one or more 
733 ASR Data Terminals other than the system console is required, enter an appropriate 
device name and the information requested in step 16 for each. 

18. Enter the following information to define other devices. Omit any that do not apply. 

* FOR FLOPPY DISC UNIT 



* ENTER NUMBER OF DRIVES (MAX 4) 

* FOR LINE PRINTER 



DEV 


NAME - 


DSC 


DEV 


TYPE - 


FD 


CRU 


BASE ADDR - 


INT 


LEVEL - 




# OF 


■ DRIVES 


- 2 


DEV 


NAME - 


LP 


DEV 


TYPE - 


LP 


CRU 


BASE ADDR - 


ACCESS MODE 


- 


INT 


LEVEL - 




TIME 


;-OUT COUNT - 



>e0 



FOR 913 VDT SYSTEM, ENTER 4. 
OTHERWISE, USE THE DEFAULT VALUE. 
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DEV NAME 
DEV TYPE 



TTY 
TTY 



* FOR TELETYPEWRITER 



PTP 
PTR 



LEFT CASS/PTP NAME - 
RIGHT CASS/PRT NAME 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 



19. Enter the following information to define emulator and trace modules. 



DEV NAME - EMU 
DEV TYPE - EMU 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 

DEV NAME - TRA 
DEV TYPE - TRA 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 



* FOR EMULATOR MODULE 



* FOR 913 VDT SYSTEM, ENTER 4. 
OTHERWISE, USE THE DEFAULT VALUE, 

* FOR TRACE MODULE 



* FOR 913 VDT SYSTEM, ENTER 4. 
OTHERWISE, USE THE DEFAULT VALUE. 



20. Enter the following carriage returns to terminate the device definition portion of 
GENTX: 



DEV NAME - 



CHASSIS - 



* NO MORE DEVICES 

* NO MORE CHASSIS 



21. Enter the following information to define the standard TXDS tasks: 
SVC # - 



XOP # - 

TASK ID# - >F0 



PRIORITY 


LEVEL - 


INITIAL 


DATA LABEL - 


TASK ID# - 
PRIORITY 


>F1 
LEVEL - I2f 


INITIAL 


DATA LABEL - 



* NO USER DEFINED SUPERVISOR CALLS 

* NO USER DEFINED EXTENDED OPERATIONS 

* FOR FLOPPY DISC DRIVE 1 
FMPl 

* FOR FLOPPY DISC DRIVE 2 
FMP2 



22. When more than two floppy disk drives are required, repeat the floppy disk drive sequence 
for each additional drive. The task ID for the third disk drive is F2i6 and the initial data label 
is FMP3. The task ID for the fourth disk drive is F3i6 and the initial data label is FMP4. 
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23. Enter the following information to define additional standard TXDS tasks: 



TASK ID# 



>B 



PRIORITY 


LEVEL - 1 


INITIAL 


DATA LABEL - 


TASK ID# - 
PRIORITY 


>D 

LEVEL - 1 


INITIAL 


DATA LABEL - 


TASK ID# - 
PRIORITY 


>F 

LEVEL - 1 


INITIAL 


DATA LABEL - 


TASK ID# - 
PRIORITY 


>16 

LEVEL - 1 


INITIAL 


DATA LABEL - 



TASK ID# 



*FILE MANAGEMENT 

ruR 

* DIAGNOSTIC TASK 
DIAGTS 

* OCP - OMIT THIS SEQUENCE WHEN OCP IS 

* NOT REQUIRED 
OCP 

* TXDS CONTROL PROGRAM 
CNTROL 

* NO MORE TASKS 



24. Enter the following information to complete GENTX: 

MULTIPLE DYNAMIC TASKS (Y OR N) - N 
CONSOLE DEV NAME - LOG 
DEFAULT DISC NAME - DSC 
DEFAULT PRINT DEV - LOG 



* NO ENTRY IF PRINT DEVICE NOT SUPPORTED 

ASSIGN LUNO~ * NO PREASSIGNED LUNOS 

# OF SPARE DEV LUNO BLOCKS - 

# OF SPARE FILE LUNO BLOCKS - 

# OF FILE CONTROL BLOCKS - 

# OF DEFAULT BUFFERS - 

# OF GENERAL BUFFERS - 

TA SKDF OUTPUT FILE NAME - :TASKDF/SRC 

* GENERATE SOURCE MODULE ON FILE :TASKDF/SRC 
TXDATA OUTPUT FILE NAME - :TXDATA/SRC 

* GENERATE SOURCE MODULE ON FILE :TXDATA/SRC 
END TX990 SYSGEN 

25. Enter the following information to execute OBJMGR to select and copy modules to an 
input file for TXLINK. 

PROGRAM: : OBJMGR/ SYS* 

991? OBJECT MANAGER 945672 *B 

OUTPUT FILE: :TXPART/OBJ 
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26. Select object modules from file :DSRLIB/OBJ. Enter C for supported devices, and S for 
devices that are not supported. Selections must be consistent with devices defines in steps 
14 through 19. Selections shown are for a system that has a 91 1 VDT, a line printer, two 
floppy disk units, an emulator, and a trace module. 



INPUT 


FILE: 


DSC2:DSRLIB/0BJ 




OPEN ] 


[NPUT FILE. 


WITH 


REWIND ? 


Y 


FPYDSR 


? 


C 








* FLOPPY DISC DSR 


DSR733 


7 


C 








* 733 ASR DSR 


KSRDSR 


? 


s 








* 743 KSR DSR 


LPDSR 


? 


c 








* LINE PRINTER DSR 


FLP 


? 


s 








* FAST LINE PRINTER 


DSR93 


? 


s 








* 913 VDT DSR 


CRDSR 


? 


s 








* CARD READER DSR 


DSRTTY 


? 


s 








* TELETYPEWRITER DSR 


DSR9n 


? 


c 








* 911 VDT DSR 


END-OF-FILE 















PSR 



27. Remove the TXDS parts diskette from the right-hand disk unit, and place the AMPL 
diskette in the right-hand unit. Select modules from file :AMPDSR/OBJ for emulator 
and trace module DSRs. Enter C to include a module. 

INPUT FILE: DSC2:AMPDSR/0BJ 

OPEN INPUT FILE, WITH REWIND ? Y 
EMDSR ? C 

TMDSR ? C 



* INCLUDE FOR EMULATOR SUPPORT 

* INCLUDE FOR TRACE MODULE SUPPORT 



28. Remove the AMPL diskette from the right-hand disk unit, and place the TXDS parts 
diskette in the right-hand unit. 



29. Select all modules from file :OCPLIB/OBJ when OCP is required. Otherwise, omit this 
step. 

INPUT FILE: DSC2:0CPLIB/0BJ 
OPEN INPUT FILE, WITH REWIND ? Y 



OCPTSK 



END-OF-FILE 



* INCLUDE ENTIRE FILE 



30. Select modules from file FMPLIB/OBJ for floppy disk drives. Enter C to include module, 
module. 



INPUT FILE: 



DSC2: FMPLIB/OBJ 



OPEN INPUT FILE. WITH REWIND ? Y 
TXFMPl ? C 
? C 
is * INCLUDE FOR THIRD FLOPPY DISC DRIVE 

I S 

? A 



TXFMP2 ? 
TXFMP3 ? 
TXFMP4 ? 
TXFMP ? 
END-OF-FILE 



* INCLUDE FOR FOURTH FLOPPY DISC DRIVE 

* INCLUDE REMAINDER OF FILE 
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31. Select the module on file :CNTROL/OBJ and appropriate modules from file 
:TXLIB/OBJ. Enter C to include module. 

INPUT FILE : DSC2 :CNTROL/OBJ 

OPEN INPUT FILE, WITH REWIND ? Y 
CNTROL ? C ~~ 

END-OF-FILE 



INPUT FILE: 



DSC2:TXLIB/0BJ 



OPEN INPUT FILE, WITH REWIND ? Y 



TXROOT 



EVENTK 



TITTCM 



CRTPRO 



STA913 



SVC913 



STA9n 



SVC9n 



lOSUPR 



END-OF-FILE 



C 
C 
S 
C 
S 
S 
C 
C 
A 



*REQUIRED FOR AMPL 

*INCLUDE TO SUPPORT EITHER VDT 

*FOR 913 VDT SUPPORT 

*FOR 913 VDT SUPPORT 

FOR 911 SUPPORT 
FOR 911 SUPPORT 

INCLUDE REMAINDER OF FILE 



*INCLUDE 
*INCLUDE 



32. Respond to next request for an input file with a carriage return, terminating OBJMGR, 
as follows: 



INPUT FILE: 
END OBJECT MANAGER 



* NO MORE FILES 



33. Remove the TX990 parts diskette from the right-hand disc unit, and place the TXDS 
system diskette in the right-hand unit. (The TXDS system diskette was removed from 
the left-hand unit in step 10). 

34. Enter the following information to execute TXMIRA to assemble modules TXDATA 
and TASKDF. 



PROGRAM 



INPUT 



OUTPUT 



TXMIRA/SYS 

TXDATA/ SRC 
TXDATA/OBJ,:TXDATA/LST 



* ASSEMBLE TXDATA 



OPTIONS: CIS 
TXMIRA 936227 



PROGRAM 



INPUT 



OUTPUT 



OPTIONS 



TXMIRA/SYS 
TASKDF/SRC 

TASKDF/OBJ,:TASKDF/LST 
CLS 



TXMIRA 936227 ** 



* ASSEMBLE TASKDF 
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35. Enter the following information to execute TXLINK to link the new system. 



PROGRAM 



INPUT 



OUTPUT 



OPTIONS 



TXLINK/SYS 

TXDATA/OBJ, :TASKDF/OBJ, :TXPART/OBJ 
NEWSYS/SYS,:NEWSYS/LST 
CLITX990 



TXLINK 937357 ** 

36. Remove the TXDS system diskette from the right-hand floppy disc unit, and place the 
TX990 parts diskette in the right-hand unit. (The TX990 parts diskette was removed 
from the right-hand unit in step 30.) 



37. Enter the following information to execute SYSUTL to copy the system loader to the 
new system diskette and to designate the newly linked system as the current system. 

PROGRAM: :SYSUTL/SYS* 

TX99ef SYSTEMS UTILITY 937544 ** 

OP: BC,DSC.SF,:NEWSYS/SYS.TE. 

38. The newly linked system may be loaded by repeating steps 2, 3, and 4. The system 
should print the initial message. Actual memory size numbers vary: 

TX990 SYSTEM RELEASE 2.2 

MEMORY SIZE(WORDS): 24576 AVAILABLE: 14631 

39. Enter an exclamation point (!). If OCP was included in the system, OCP begins execution 
and prints a period (.) to request input. If OCP was not included, TXDS begins execution 
and prints the message shown in step 40. 

40. Enter the following to execute TXDS if OCP was included: 

^ EX,16.TE. 

41. TXDS prints the following: 

TXDS 936215 ** 1/0 0: 

Should the system fail to begin execution or to execute OCP or TXDS, carefully check the 
parameters supplied to GENTX and the other input to the system generation process. If an error 
is identified, repeat the procedure correctly. 
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APPENDIX B 
DXIO SYSTEM GENERATION 



B.l INTRODUCTION 

The DXIO operating system supplied by Texas Instruments does not support the emulator and trace 
modules for an AM PL system. The user must generate a version of DX 10 that supports these modules 
as Special Devices and must install the AM PL program in the newly generated system in order to 
execute the AMPL program under DXIO. System generation requires execution of the following 
system utilities: 

• SDSTIE — text editor 

• GEN990 — auto sysgen utility 

• SDSMAC — macro assembler 

• SDSLNK — link editor 

The user should have a basic knowledge of the operation of these utilities. Generating a system requires 
the following: 

• A system disk volume that contains the DXIO object modules (accessed through directory 
.SSSYSGEN). 

• The AMPL disk volume or the AMPL parts already installed on the system disk. 

• The AMPL installation package. 

The AMPL installation package may reside on the system disk volume, on a separate disk volume, 
or on magnetic tape. When the package is on magnetic tape, perform the procedures in paragraph 
B.8 to copy the package to either the system disk or to a separate disk volume, then generate the 
system. On either medium, the installation package is defined in directory DXAMPL30. 

This appendix describes the initial steps prior to system generation, execution of the text editor to 
prepare the PDT modules, and execution of the auto sysgen utility. The appendix also describes 
preparing the generated system for execution and installation of the system as the primary system. 
Finally, this appendix describes installation of the AMPL program in the newly created system. 

B.2 INITIAL STEPS 

When the installation package is on a separate disk volume, that volume must be installed and the 
modules required for system generation must be moved to the system disk volume. In all cases, 
synonyms must be assigned and the modules required must be cataloged in directory .SSSYSGEN. 
The following procedure assumes that DXIO has been loaded and initialized, and is executing. If 
not, perform steps 1 through 19 of paragraph 5.2.2 prior to the following procedure: 

1. Mount the volume containing directory DXAMPL30 in a disk unit and place the unit 
in ready. Omit this step when the directory is already on the system disk. 
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2. Press the blank orange key (upper right of keyboard) on the Model 91 1 VDT to be used to 
input commands. If the terminal that was used to initialize DX 10 is to be used, omit this step 
and skip to step 6. 

3. Verify that the UPPER CASE LOCK key is in the upper case position. 

4. Enter an exclamation point (!). When the system displays the initial menu of the System 
Command Interpreter (SCI), no log in is required and you may skip to step 6. Otherwise, the 
system diplays: 

SYSTEM COMMAND INTERPRETER— PLEASE LOG IN 
USER ID: 
PASSCODE: 

5. Enter the identifier that you have been assigned, and press the RETURN key. 

6. Enter your passcode and press the RETURN key. The system displays the initial SCI menu 
if the identifier and passcode are valid. If not, you may have entered the identifier or 
passcode incorrectly, or your privilege level may be too low for the terminal. Either reenter 
the identifier and passcode correctly, or use a terminal with a lower privilege level, 
respectively. If directory .DXAMPL30 already resides on the system disk skip to step 10. 

7. Enter the following command to install the disk volume: 

IV 
The system displays: 

INSTALL VOLUME 
UNIT NAME: 
VOLUME NAME: 

8. Enter the device name of the disk unit in which the AMPLdisk volume was mounted; e.g., 
DS02, DS03, etc. 

9. Enter the volume name as follows: 

VOLUME NAME: DXAMPL30 

10. Enter the following command to assign a synonym for the system disk volume: 

AS 
The system displays: 

ASSIGN SYNONYM VALUE 

SYNONYM: 

VALUE: 



B-2 Digital Systems Division 




946244-9701 



1 1. Enter the synonym as follows: 

SYNONYM:DSC 

12. Enter the volume name of the system disk volume as the value. 

13. Enter AS to assign a synonym to DXAMPL30. The display is shown in step 10. 

14. Enter the synonym as follows: 

SYNONYM: AMPL 

15. Enter the value as follows: 

VALUE: DXAMPL30 (If AMPL parts are on a separate disk) 
VALUE: .DXAMPL30 (If AMPL parts are on the system disk) 

16. Enter the following command to execute a batch procedure: 

XB 
The system displays: 

EXECUTE BATCH 
INPUT ACCESS NAME: 
LISTING ACCESS NAME: 

17. Enter the pathname of the file that contains the batch procedure, as follows: 

INPUT ACCESS NAME:AMPL.AMPL$IGP 

18. Enter the Line Printer as the listing device, as follows: 

LISTING ACCESS NAME: LPOl 

The batch procedure on file AMPL. AMPLSIGL copies the AMPL software modules onto the system 
disk, cataloged in directory .SSSYSGEN. Messages output during execution of the procedure are 
printed on the hne printer. 

B.3 EXECUTING TEXT EDIT 

A DXIO system requires a Peripheral Device Table (PDT) for each device supported by the system. 
The AMPL disk volume contains source code modules for two generalized PDTs, one for the emulator 
and one for the trace module. These PDTs must be made specific by placing the correct device name in 
certain source code statements and the interrupt-level-minus-one in another source code statement. 
The user executes the Text Editor to insert the correct data into the source code statements, and to copy 
the resulting source code into a source code module for the PDT for a specific device. The generalized 
emulator PDT may be edited and copied as many times as required to obtain a PDT for each emulator. 
Similarly, the generalized trace module PDT may be edited and copied for each trace module. 
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The device name of the emulator in a single-emulator laboratory is EMOl, and additional emulators 
are EM02 . . . EMOn, where n is the total number of emulators. Similarly, when only one trace module 
is included, the device name is TMOl. Additional trace modules are TM02 . . . TMOn, where n is the 
total number of trace modules. Device names EMnn and TMnn are also valid when more than nine 
emulators or trace modules are included. 

The interrupt level for an emulator or trace module that is installed in an expansion chassis is 
determined by the slot in the main chassis into which the CRU expander board is connected. The same 
interrupt level applies to all emulators, trace modules, or other devices in all expansion chassis 
connected to the expander. The chassis number and position number are supplied to the auto sysgen 
utility to provide for identifying the specific device on the interrupt level. The interrupt level for an 
emulator or trace module that is installed in the main chassis is determined by the slot into which it is 
installed. The interrupt-level-minus-one value is the difference obtained by subtracting one from the 
interrupt level; e.g., 12, for interrupt level 13. 

The following procedure calls the Text Editor to edit a PDT for the first or only emulator and a PDT 
for the first or only trace module. Perform the following steps: 

1. Enter the following command: 

XE 
The system displays the following: 
INITIATE TEXT EDITOR 
FILE ACCESS NAME: 

2. Enter the name of the file that contains the generahzed emulator PDT, as follows: 

FILE ACCESS NAME: .S$SYSGEN.PDT$EM 

3. Enter the following command to replace the string ?I with the interrupt-level-minus-one: 

RS 
The Text Editor displays the following: 
REPLACE STRING 

NUMBER OF OCCURRENCES: 1 

START COLUMN: 1 

END COLUMN: 80 

STRING: 

CHANGE: 

4. Press the TAB key to enter the displayed number of occurrences. 
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5. Enter the number of the first column of the field in which ?I occurs: 

START COLUMN: 13 

6. Enter the number of the last column of the field in which ?I occurs: 

END COLUMN: 20 

7. Enter the characters of the string to be replaced: 

STRING: ?I 

8. Enter the value of interrupt-level-minus-one; the following value applies to interrupt level 
13: 

CHANGE: 12 

9. The Text Editor executes the command and displays the line in which ?I is replaced, as 
follows: 

9 DATA 12 R2 = STATUS FLG/INTERRUPT-1 

10. Enter the following command to terminate the edit operation and create the file specifically 
for EMOl: 

QE 

The Text Editor displays the following: 

QUIT EDIT 

ABORT?: NO 

11. Press the TAB key to enter the displayed response: 
The Text Editor displays the following: 

QUIT EDIT 

OUTPUT FILE ACCESS NAME: S$SYSGEN.PDT$EM 

REPLACE?: NO 

MOD LIST ACCESS NAME: 

12. Enter the name of the PDT file for EMOl as follows: 

OUTPUT FILE ACCESS NAME: .S$SYSGEN.PDT$EMOI 

13. Press the TAB key to enter the displayed NO response. 

14. Press the RETURN key to execute the command. 
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15. Enter the following command: 

XE 
The system display is shown in step 1. 

16. Enter the name of the file that contains the generalized trace module PDT, as follows: 

FILE ACCESS NAME: .S$SYSGEN.PDT$TM 

17. Enter the following command to replace the string ?I with the intcrrupt-level-minus-one: 

RS 
The Text Editor display is shown in step 3. 

18. Enter the number of occurrences of ?I as follows: 

NUMBER OF OCCURRENCES: 1 

19. Enter the number of the first column of the field in which ?I occurs: 

START COLUMN: 13 

20. Enter the number of the last column of the field in which ?I occurs: 

END COLUMN: 20 

21. Enter the characters of the string to be replaced: 

STRING: ?I 

22. Enter the value of interrupt-level-minus-one; the following value applies to interrupt level 
13: 

CHANGE: 12 

23. The Text Editor executes the command and displays the line in which ?I is replaced, as 
follows: 

9 DATA 12 R2 = STATUS FLG/INTERRUPT-1 

24. Enter the following command to terminate the edit operation and create the file specifically 
for TMOl: 

QE 

The Text Editor display is shown in step 11. 

25. Press the TAB key to enter the displayed output file access name. 

26. Press the TAB key to enter the displayed NO response. 

27. Press the RETURN key to execute the command. 
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The preceding procedure does not alter the device name; the device name in .S&SYSGEN PDTSEM is 
EMOI and the device name in .S&SYSGEN.PDT$TM is TMOl. For additional emulators and trace 
modules, perform the following steps: 

1 . Perform steps 1 and 2 of the preceding procedure. 

2. Enter the following command to replace the string EMOI with the device name of an 
additional emulator: 

RS 

The system display is shown in step 3 of the preceding procedure. 

3. Enter the number of occurrences of EMOI as follows: 

NUMBER OF OCCURRENCES: 7 

4. Enter the number of the first column in which EMOI appears in any source statement: 

START COLUMN: 1 

5. Enter the number of the last column in which EMOI appears in any source statement: 

END COLUMN: 25 

6. Enter the characters of the string to be replaced: 

STRING: EMOI 

7. Enter the device name of an additional emulator. The example applies to the second 
emulator: 

CHANGE: EM02 

8. The Text Editor executes the command and displays the last line in which EMO 1 is replaced, 
as follows: 

41 PLEM02 EQU $-PSEM02 LENGTH OF PDT 

9. Enter the following command to return to the beginning of the file: 

SL 
The Text Editor displays the following: 
SHOW LINE 
LINE: 1 

10. Press the TAB key to enter the displayed line number in preparation for another Replace 
String command. 

1 1. Perform steps 3 through 16 of the preceding procedure. 
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1 2. Enter the following command to replace string TMO 1 with the device name of an additional 
trace module: 

RS 

13. Enter the number of occurrences of TMOl as follows: 

NUMBER OF OCCURRENCES: 7 

14. Enter the number of the first column in which TMOl appears in any source statement: 

START COLUMN: 1 

15. Enter the number of the last column in which TMOl appears in any source statement: 

END COLUMN: 25 

16. Enter the characters of the string to be replaced: 

STRING: TMOl 

17. Enter the device name of an additional trace module. The example applies to the second 
emulator: 

CHANGE: TM02 

18. The Text Editor executes the command and displays the last line in which TMOl is replaced, 
as follows: 

41 PLTM02 EQU $-PSTM02 LENGTH OF PDT 

19. Enter the following command to return to the beginning of the file: 

SL 
The Text Editor display is shown in step 9. 

20. Press the TAB key to enter the displayed hne number. 

21. Perform steps 17 through 27 of the preceding procedure. 

22. Repeat this procedure for each additional emulator and trace module, using the proper 
device names. 

B.4 EXECUTING GEN990 

GEN990, the auto sysgen utility, builds a source code file for the operating system data base and a 
control file for the linking operation from responses supplied by the user. GEN990 displays requests 
for system parameters, and accepts commands that support the input of the required data. An 
important capability of GEN990 is that of displaying two levels of description for most of the requested 
parameters. 
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GEN990 processes the emulator and trace module as special devices. The responses shown in the 
example for these devices are required for support of these devices. The other responses are typical; the 
devices specified are those of a recommended AMPL system. An actual DXIO system may support 
other devices and/ or additional devices. Similarly, other parameters may require different values in a 
system, to meet the requirements of specific applications. 

The following procedure calls and executes GEN990 to generate a DXIO system that supports an 
AMPL laboratory: 

1. Enter the following command to activate GEN990: 

XGEN 

The system displays the following: 
EXECUTE AUTO SYSGEN 



= ^ = = = = = = = = = = ^ = GEN990-AUTO SYSGEN RELEASE 3.1** = = = - = = = = = 

2. Enter the indicated responses to the requests displayed. For further information about the 
parameters, refer to Model 990 Computer DXIO Operating System Release 3 Reference 
Manual Vol. 5. Notice that the default values are shown in parenthesis in each 
prompt. Specify the initial system parameters as follows: 

DATA DISK: (DSOl) 

TARGET DISK: (DSOl) 

INPUT: 

OUTPUT: SYSl 

LINE: (60) 

SLICE: (50) 

QUEUE 0: (10) 255 

QUEUE 1: (10) 255 

QUEUE 2: (10) 255 

QUEUE 3: (10) 255 

TABLE: 6000 See note 

COMMON: (NONE) 

INTERRUPT DECODER: (NONE) 

FILE MANAGEMENT TASKS: (2) 

CLOCK: (5) 

ID: (NONE) 

OVERLAYS: (2) 

SYSLOG: (6) 

BUFFER MANAGEMENT: (IK) 

I/O BUFFERS: (0) 1152 See note 

INTERTASK: (100) 

KIF? (YES) NO 

SCI BACKGROUND: (2) 

SCI FOREGROUND: (8) 

BREAKPOINT: (16) 

CARD 1: 10 

CARD 2: 
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NOTE 

The values shown for the TABLE response and for the I/O 
BUFFERS are typical, but may not be adequate for systems with 
many peripherals or systems with multiple emulator and trace 
modules. The value for TABLE may be estimated using the informa- 
tion displayed when the WHAT? command is entered the second 
time. The value for I/O BUFFERS allows 512 bytes for an emulator 
module and 640 words for a trace module. This may be adequate for 
multiple emulators and trace modules when contention for buffer 
space is rare (e.g., concurrent use of more than one emulator and 
trace module is infrequent). 

3. Enter the following responses to define the supported devices: 



DEVICE: DS 

TILINE: (F800) 

DRIVES: (1) 2 

DEFAULT RECORD SIZE: (864) 

INTERRUPT: (13) 

DEVICE: LP 

CRU: ()60) 

ACCESS TYPE: (FILE) 

TIME OUT: (30) 

WIDTH: (80) 132 

PRINT MODE: (SERIAL) 

EXTENDED? (NO) YES 

3270 CRU ADDRESS: (NONE) 

INTERRUPT: (14) 

DEVICE: ASR 

CRU: ()00) 

ACCESS TYPE: (RECORD) 

TIME OUT: (0) 

CASSETTE ACCESS TYPE: (FILE) 

CASSETTE TIME OUT: (3) 

CHARACTER QUEUE: (6) 

INTERRUPT: (6) 

DEVICE: CRT 

CRU: ()C0) >0500 

ACCESS TYPE: (RECORD) 

TIME OUT: (0) 

CRT TYPE: (913) 911 

3270 CRU ADDRESS: (NONE) 

CHARACTER QUEUE: (6) 

INTERRUPT: (11) 10 

EXPANSION CHASSIS: (1) 

EXPANSION POSITION: 3 



Define the disk controller 



Define the line printer 



Define the 733 ASR data terminal 



Define 911 VDT 
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4. Enter the following responses to define the emulator and trace modules: 

DEVICE: SD Define emulator 

CRU: ()20)X)440 

INTERRUPT CRU BIT: (NA) 

NAME: EMOl 

KSB: (NONE) 

DSR WORKSPACE: PDEMOl 

INTERRUPT ENTRY: EMINT 

PDT FILE: .SSSYSGEN.PDTSEMOl 

DSR FILE: .S$SYSGEN.DSR$EM 

OVERRIDE? (YES) 

INTERRUPT: (15) 10 

EXPANSION CHASSIS: (1) 

EXPANSION POSITION: 1 

DEVICE: SD 

CRU: ()20) >0400 Define trace module 

INTERRUPT CRU BIT: (NA) 

NAME: TMOl 

KSB: (NONE) 

DSR WORKSPACE: PDTMOl 

INTERRUPT ENTRY: TMINT 

PDT FILE: .S$SYSGEN.PDT$TM01 

DSR FILE: .S$SYSGEN.DSR$TM 

OVERRIDE? (YES) 

INTERRUPT: (15) 10 

EXPANSION CHASSIS: (1) 

EXPANSION POSITION: 2 

5. Repeat the entries of step 4 (with appropriate CRU addresses, names, DSR workspaces, and 
PDT files) for additional emulators and trace modules as required. 

6. Enter the following response to complete the input to GEN990: 

DEVICE: No more devices 

SVC: No user-supplied supervisor calls 

XOP: No user-supplied XOPs 

7. Enter the following responses to terminate GEN990: 

CONFIGURATION FILE IS COMPLETE. DO YOU WANT TO SAVE IT? (YES) 

*»»•»••**• CONFIGURATION FILE SAVED ♦«»••»**** 

»»••**** DSDATA SOURCE FILE IS NOW BEING BUILT »•**••**** 

•»••*•** THE SDSLED COMMAND STREAM SOURCE FILE IS BEING BUILT •* 

* BATCH FILE FOR SYSGEN COMPLETION IS NOW BEING BUILT ••*••*♦ 

8. GEN990 displays the following question. If the user enters Y instead of N as shown in the 
following example, GEN990 displays detailed instructions for assembling DSDATA and 
linking the system. If the terminal which called GEN990 is a 733 ASR, GEN990 prints a 
convenient set of instructions. 

DO YOU NEED INSTRUCTIONS TO COMPLETE THE SYSGEN? NO 
********* GEN990 TERMINATED ********* 
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B.5 COMPLETING SYSTEM GENERATION 

The data base for the system must be assembled and linked with the remainder of the system. 
GEN990 has created a batch stream to assemble and link the system. The ALGS procedure may be 
called to bid this batch stream. 

Prompt Response 

TARGET DISK: (target) 

SYSTEM NAME: (output) 

DSDATA LISTING: (user defined) 

BATCH LISTING: (user defined) 

where 

(target) = target disk specified in sysgen 
(output) = output parameter definition 

When this batch stream completes without any errors, the message ***ALGS - NORMAL 
COMPLETION *** appears on the screen. If any other message appears, an error has occurred and 
the batch listing should be examined to determine the cause of the error. 

After the system is Unked, the patch stream must be run against the linked image. To patch the 
system, bid the PGS procedure. 

Prompt Response 

TARGET DISK: (target) 

SYSTEM NAME: (output) 

BATCH LISTING: (user defined) 

When the batch stream is completed without errors, the message *** PGS - NORMAL TERMI- 
NATION *** appears on the screen. If any other message appears, an error has occurred and the 
batch Hsting should be examined to determine the cause of the error. 

B.6 INSTALLING AND TESTING THE SYSTEM 

When the batch commands have been executed, generation of the system is complete, and it is ready 
to be installed as the secondary system for test purposes. To set up this system to be tested at IPL 
time, bid the TGS procedure. 

Prompt Response 

TARGET DISK: (target) 

SYSTEM NAME: (output) 

After the procedure is entered, it displays the system IPL status. The system name should be the 
secondary system and the IPL status should say TEST SECONDARY SYSTEM. 

The system can now be booted so that the new system can be tested. Verify that the new system is 
acceptable. If it is not, the system can be booted and control returns to the original system. 
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Perform the procedure in paragraph 5.2.2 to load the newly generated system. Execute the Hardware 
Demonstration Test to verify system operation. If it is not possible to load the system or to perform 
the test properly, verify the system generation. When the system is acceptable, it may be installed as 
the primary system by bidding the IGS procedure. 

Prompt Response 

TARGET DISK: (target) 

SYSTEM NAME: (output) 

After the procedure is entered, it displays the current IPL status. The system specified should be the 
primary system and the IPL status should be set to IPL the primary system. The sysgen is then 
complete. 

B.7 INSTALLING THE AMPL PROGRAM 

In order to conveniently execute the AMPL program under a DX 10 system, the SCI command A M PL 
must be defined, the software must be installed, the error text file must be installed, and the AMPL 
menu must be installed. The AMPL software disk volume contains these items and a set of SCI batch 
commands to install them in the system. If this procedure is not beingdone foliowinggeneration ot tlic 
DXIO system that supports an AMPL laboratory, perform steps 1 through 15 of the procedure in 
paragraph B.2 prior to the following procedure. Then perform the following steps: 

1. Check that program file .S$SDS$ is not protected. This is the program file 
on which the AMPL task and procedure are to be installed. 

2. Enter the following command to assign a synonym to the system program liie: 

AS 

The system displays: 

ASSIGN SYNONYM VALUE 

SYNONYM: 

VALUE: 

3. Enter the synonym as follows: 

SYNONYM: PROGE 

4. Enter the pathname of the program file as the value: 

VALUE: . S$SDS$ 

5. Enter the following command to execute the batch commands: 

XB 

The system displays: 

EXECUTE BAICH 
INPUT ACCESS NAME: 
LISTING ACCESS NAME: 
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6. Enter the pathname of the file that contains the batch commands, as follows; 

INPUT ACCESS NAME: AMPL.AMPLSIAT 

7. Enter the Line Printer as the listing device, as follows: 

LISTING ACCESS NAME: LPOl 

When the execution of the batch commands completes, the AM PL laboratory is installed in the DX 1 
system. 

The AMPL software installed by the preceding procedure includes an SCI command, AMPL, that is 
executed to call the AMPL program. The command requests the user to specify the amount of memory 
in 1 K word (2K byte) blocks, and provides a default value of 8 for 8K words ( 16K bytes). The user may 
change the default value to any number from 1 through 32 ( 1 K through 32K words, or 2K through 64K 
bytes) by performing the following steps: 

1. Enter the following command to activate the Text Editor: 

XE 

The system displays the following: 

INITIATE TEXT EDITOR 
FILE ACCESS NAME: 

2. Enter the pathname of the AMPL SCI command file, as follows: 

FILE ACCESS NAME: SSPROC.AMPL 

3. When the Text Editor displays the cbmmand, position the cursor oh the following line: 

USER MEMORY (K) = INT (8) 

4. Move the cursor to the number in parentheses (8 originally) following the keyword INT, and 
enter the desired number. The following example shows the contents of the line for a default 
value of 10: 

USER MEMORY (K) = INT (10) 

5. Press the CMD key and enter the following command: 

QE 

The Text Editor displays the following: 

QUIT EDIT 

ABORT?: NO 
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6. Press the TAB key to enter the NO response. 

The Text Editor displays the following: 

QUIT EDIT 

OUTPUT FILE ACCESS NAME: .SSPROC.AMPL^ 

REPLACE?: NO 

MOD LIST ACCESS NAME: 

7. Press the TAB key to specify the input file for output. 

8. Enter YES to specify replacing the old file with the edited file: 

REPLACE?: YES 

9. Press the RETURN key to execute the command. 

Subsequent executions of the AMPL SCI command display the newly entered default value for 
memory size. 

After the AMPL Laboratory has been installed, and the memory size default value changed if 
necessary, synonyms AMPL, DSC, and PROOF may be deleted. To delete synonym AMPL, perform 
the following steps: 

1. Enter the following command: 

AS 

The system displays: 

ASSIGN SYNONYM VALUE 

SYNONYM: 

VALUE: 

2. Enter the synonym as follows: 

SYNONYM: AMPL 

3. Press the TAB key to enter blanks for the value, deleting the synonym. 

4. Repeat the preceding steps to delete synonyms DSC and PROOF. 
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I B.8 DXIO SYSTEM GENERATION AND AMPL PROGRAM INSTALLATION FROM 
MAGNETIC TAPE 

When the AMPL software is supplied on magnetic tape, the software may be copied to a disk volume. 
The disk volume may then be used in system generation and in AMPL program installation as 
previously described for software supplied on a disk volume. To copy the software, which is listed in 
directory DXAMPL30, perform the following steps: 

1 . Mount the magnetic tape that contains the installation package on an available magnetic 
tape unit and place the unit in ready. 

2. If the system disk is not to be used for the disk files to be written, install the scratch secondary 
disk in a disk unit. 

3. Enter the following command to assign a synonym to the file to be written: 
AS 

The system displays: 

ASSIGN SYNONYM VALUE 

SYNONYM: 

VALUE: 

4. Enter the synonym as follows: 
SYNONYM: AMPL 

5. Enter the value, consisting of the disk volume name concatenated with the directory name 
DXAMPL30. The volume name used in the following example is VSYS: 

VALUE: VSYS.DXAMPL30 

6. Enter the following command to copy the file from tape to disk: 
RD 

The system displays the following: 

RESTORE DIRECTORY 

SEQUENTIAL ACCESS NAME 

DIRECTORY PATHNAME 

LISTING ACCESS NAME 

OPTIONS 

7. Enter the device name of the magnetic tape unit on which the tape was mounted. The 
example uses device name MTOl, as follows: 

SEQUENTIAL ACCESS NAME: MTOl 
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8. Enter the directory pathname as follows: 

DIRECTORY PATHNAME: AMPL 

9. Press the TAB key to enter the default value for the listing access name. 

10. Enter the option as follows: 

OPTIONS: ADD 

1 1 . Perform the steps of system generation and program installation using the files copied to the 
disk. Do not assign a new value to synonym AMPL. 

The user may either retain the files on the disk or delete it. To delete the files perform the following 
steps: 

1. Enter the following command to delete the file directory: 

DD 

The system displays the following: 

DELETE DIRECTORY 

PATHNAME 

LISTING ACCESS NAME 

ARE YOU SURE? 

2. Enter AMPL as the pathname, as follows: 

PATHNAME: AMPL 

3. Press the TAB key to enter the default value for the listing access name. 

4. Enter YES to cause the directory and files to be deleted, as follows: 

ARE YOU SURE?: YES 

If the files are to remain on the disk, perform the third procedure in paragraph B.7 to delete the | 
synonyms. 
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APPENDIX C 
AMPL GRAMMAR 



The following is a formal definition of the AMPL grammar. An arrow in a statement means 
"consists of. A vertical line on a subsequent line of a statement means "or". Words in upper 
case letters are entered as shown. Words in lower case letters enclosed in angle brackets are 
defined in grammar statements. Words in lower case letters that are not enclosed in angle 
brackets are defined in the note that follows the grammar definition. 

<amplprog> ^ <stmt> 

1 PROC <procname> <parm1ist> <stnit> 

I PROC <procnanie> <stnit> 

! FUNC <funcname> <parmlist> <stmt> 

I FUNC <f uncname> <stmt> 

<procname> -> <procnaine> 
I name 

<funcnanie> -> <funcname> 
I name 

<parmlist> ^ (constant, constant) 
! (constant) 

<stmt> ^ BEGIN <stmtlist> END 
I IF <expr> THEN <stmt> 
I IF <expr> THEN <stmt> ELSE <stmt> 
! WHILE <expr> DO <stmt> 
) REPEAT <stmt> UNTIL <expr> 
i CASE <expr> OF <case1ist> ELSE <stmt> 
I CASE <expr> OF <caselist> 

I FOR <leftpart> = <expr> TO <expr> BY <expr> DO < stmt > 
j FOR <leftpart> = <expr> TO <expr> DO < stmt > 
i <proccall> 

l<proccall> (<arg1ist>) 
! RETURN 

I RETURN <expr> 
I <assign> 
i <display> 
I NULL 
I <stmt>; 

[ARRAY <arraylist> 
i ESCAPE 

<stmtlist>^ <stmtlist > ; < stmt> 
'f <stmt> 

<proccan> ^ <procname> 
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<arraylist> ^ <arraylist>, <arrayname> <exprlist> 
I <arrayname> <exprlist> 

<arraynanie> ^- <arrayname> 
I name 

<caselist> ^ <expr>: :<stnit> 

l<caselist> <expr ::<stmt> 

<assign> -> <left part> = <expr> 

<left part> ->■ symbol 

l@<primary> 
I undefined 
i<arrayname> 
l<arrayname> <exprlist> 

<display> -> string 
I <expr> 

l<expr>: format 
I <expr>? 

I <expr>: format ? 
i<expr>: format ? :<format> 
I <range>? 

I <range>: format ? 
l<range>: format ? : format 

<range> -> <expr> TO <expr> 

<exprlist> -> (<expr>) 

I (<expr>,<expr>) 

<expr> -^ <expr> OR <expr> 
I <expr> AND <expr> 
I NOT <expr> 
i <expr> relop <expr> 
i <expr> addop <expr> 
J <expr> multop <expr> 
I <primary> 

<primary> -^ {<expr>) 
1 symbol 
I constant 
I @ <primary> 
I addop <primary> 
I <funccall> 

i<funccall> (<arglist>) 
I <arrayname> <exprlist> 

<funccall> -^ <funcname> 

<arglist> -^ <arglist>,<expr> 
I <arglist>,<string> 
I <expr> 
I string 
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Note: The items in the grammar definition that are not defined in the statements of the definition 
are as follows: 

addop - The addition or subtraction operator; i.e., + or -. 
constant — A constant. 

format - A format specification consisting of one or more of the format characters in 

table 2-2. 

multop ~ The multiplication or division operator; i.e., *,/, or MOD. 

name - A user symbol that is a procedure, function, or array name. 

relop - A relational operator; i.e., EQ, GE, GT, HI, HIE, LE, LO, LOE, LT, or NE. 

string — A character string. 

symbol — A user symbol or variable. 

undefined - A user symbol or variable not previously defined. 
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APPENDIX D 
AMPL STATEMENT SUMMARY 

The statements of AMPL language with the syntax for each statement are as follows: 
ARRAY statement: 

ARRAYk5<array nanie>(<expr>[,<expr>])[,<array name>(<expr>[,<expr>])]. . 

Assign statement: 

<symbol> = <expression> 

CASE statement: 

CASE|!i<expr>|!JOFfei<expr> : : <s tmt> ; [<expr> : : <stnit> ; ] . . . [|[5ELSE|!5<stmt>]0END 

Compound statement: 

BEGINk5<statement>[[;]<statement>]. . .liiEND 

Display statement: 

<adclr>[t5TOfe5<addr>][:<format>. . .][?[:<format>. . .]] 
ESCAPE statement: 

ESCAPE 

FOR statement: 

FORt4<symbol>=<expr>|4TO|6<expr>[|i)BY0<expr>]|iDO|!l<stnit> 

FUNC statement: 

FUNC|6<f unction nanie>[(<parml>[,<parni2>])]<statement> 

IF statement: 

IF<expression>0THEN|ii<statenient>[|iiELSEt!5<statement>] 
NULL statement: 

NULL 
PROC statement: 

PR0C|!5<procedure nanie>[(<parnil>[,<parm2>])]<statement> 
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REPEAT statement: 

REPEAT|!5<statement>(5UNTILti<expression> 

RETURN statement: 

RETURN [|6<express i on> ] 

WHILE statement 

WHILE|6<expression>0DO|i5<statement> 
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APPENDIX E 
AMPL RESERVED WORDS 

The following are the reserved words of the AMPL language: 

AND 

ARC 

ARRAY 

BEGIN 

BY 

CASE 

DO 

ELSE 

END 

EQ 

ESCAPE 

FOR 

FUNC 

GE 

GT 

CUBED 

HI 

HIE 

IF 

LE 

LO 

LOC 

LOE 

LT 

MOD 

NE 

NOT 

NULL 

OF 

OR 

PROC 

REPEAT 

RETURN 

THEN 

TO 

UNTIL 

WHILE 
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APPENDIX F 
SYSTEM SYMBOLS 

The following is a list of system symbols and their definitions: 

ADDR - An operand keyword used in the ECMP, ETRC, TCMP, and TTRC commands. 

CC - A system variable that contains a running total of clock cycles. 

CRUB - A system variable that contains the CRU base address for the CRUR and CRUW com- 
mands. 

DO - D3 - Operand keywords that name high order data bits in TCMP command. 

DATA - An operand keyword used in the TCMP and TTRC commands. 

DAY - A system variable that contains the day of the year. The user may only read this variable. 

DBIN - An operand keyword used in the ECMP, TTRC, TCMP, and TTBH commands. 

DEF - An operand keyword used in the LOAD command. 

DST - A system variable that contains the destination address of an instruction being displayed in 
the instruction mode. 

EACH - An operand keyword used in the TEVT command. 

EDGE - An operand keyword used in the TEVT command. 

EMT - A system variable that identifies the type of microprocessor being emulated. The user may 
only read this variable. Values are: 

= TMS 9980 microprocessor 

1 = TMS 9900 microprocessor 

EMU - An operand keyword used in the TBRK, TTRC, TCMP, and TTBH commands. 

ENI ~ A system variable that contains the number of emulator interrupts that have occurred since 
the emulator was started, when the EBRK command specifies turning breakpoints off. The 
user may only read this variable. 

EST - A system variable that contains the current status of the emulator module. The user may 
only read this variable. 

ETBN - A system variable that contains the index of the newest address stored in trace memory 
of the emulator. The user may only read this variable. 
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ETM - A system variable that maps trace memory into target system memory addresses FEOOi ^ 
through FFFF j ^ • Values are : 

= Target system memory 

1 = Trace memory 

BUM - A system variable that maps user memory into target system memory addresses through 
IFFFig. Values are: 

= Target system memory 

1 = User memory 

EVT - An operand keyword used in the EBRK and TBRK commands. 

EXT - An operand keyword used in the EEVT, ETRC, TEVT, and TTRC commands. 

FULL - An operand keyword used in the EBRK and TBRK commands. 

HCRB - A system variable that contains the CRU base address for the host CRU commands 
HCRR and HCRW. 

HR - A system variable that contains the hour of the day. The user may only read this variable. 

lAQ - An operand keyword used in the ECMP, ETRC, TCMP, TTRC, and TTBH commands. 

IDT - An operand keyword used in the LOAD command. 

INT - An operand keyword used in the EEVT, ETRC, TEVT, and TTRC commands. 

INV — An operand keyword used in the TEVT command. 

MC - A system variable that contains a running total of memory accesses. 



MDR - A system variable used with the MPY and DIV commands, and with addition and sub- 
traction operations in expressions. Contains the most significant 16 bits of the product 
or the remainder. Is set to one when a carry occurs in an addition or subtraction operation, 
and to zero when a carry does not occur in an addition or subtraction. The user places the 
most significent 16 bits of the dividend in MDR for a division operation. 

MIN - A system variable that contains the minute of the hour. The user may only read this 
variable. 

NORM - An operand keyword used in the TEVT command. 

OFF - An operand keyword used in the EBRK, ECMP, ETRC, TBRK, TCMP, and TTRC com- 
mands. May also be used in an assign statement to assign the value of zero to a variable. 

ON - An operand keyword in the TTRC command. May also be used in an assign statement to 
assign the value of one to a variable. 
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PC - A system variable that contains the value in the target system program counter. 

QO - Operand keyword used in emulation control and data mode to specify odd address selection 
for the TMS 9980 microprocessor. 

Q0-Q3 - Operand keywords that name quahfier bits in the TTRC command. 

R0-R15 - System variables that contain the values in the target system workspace registers. 

REF - An operand keyword used in the LOAD command. 

SEC - A system variable that contains the second of the hour. The user may only read this variable 
variable. 

SELF - An operand keyword used in the EBRK and TBRK commands. 

SRC - A system variable that contains the source address of an instruction being displayed in the 
instruction mode. 

ST - A system variable that contains the value in the target system Status Register. 

TIME - A system variable used as a switch to control printing of instruction time counts when 
data is displayed in the instruction mode. 

TNE - A system variable that contains the number of trace module events that have occurred 
since the module was started. The user may only read this variable. 

TNI - A system variable that contains the number of trace module interrupts that have occurred 
since the module was started. The user may only read this variable. 

TST - A system variable that contains the current status of the trace module. The user may only 
read this variable. 

TTBN - A system variable that contains the index of the newest value stored in memory of the 
trace module. The user may only read this variable. 

TTBO - A system variable that contains the index of the oldest value stored in memory of the 
trace module. The user may only read this variable. 

WP A system variable that contains the value in the target system workspace pointer. 

YR - A system variable that contains the year. The user may only read this variable. 
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APPENDIX G 
USER COMMANDS 

The commands supported by AMPL software with the syntax for each command are as follows: 
CLR(<symbols>) 
CLSE; 

!'<device name>' ) 
OFF J) 

ON ) 

COPY([<access nanie>)] 

CRLIR(<displacement>,<length>) 

CRUW(<displacement>,<length>,<value>) 

DELE('<name>' [^'<name>']. . .) 

DIV(<divisor>,<dividend>) 

DR; 

DUMP ('<access name>' ,<start>,<end>[,<entry>]) 
EVT ) 



{ADDR ) 

EDItCC access name ')] 
EEVT[({i;||})] 

EOF; 

EHLT; 

EINT('<device name>' ) 

ERUN; 

ETB(<index>) 
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ADDR ) ,.f.j. 

ETRC[({[ADDR+]IAQk,<count>[,|^J|}]])] 

EXIT [('< access name> ', < start > , <enci> [ , <entry>])] 
HCRR(<displacement>,<length>) 

HCRW(<displacement>,<length>,<value>j 

('<access name>') 
LIST({ OFF [) 

( ^^ ) 

L0ADC<accessname>'[.<bias>[,fDT^t7p^^t^D^'^^}]]) 

MDEL; 

MPY(<mul ti pi i cand> ,<tnu1 ti pi ier> ) 

MSYM; 

NL; 

0PEN( '<access nanie>') 

READ; 

RSTR( '<access name>') 

SAVE('<access name>'[,<start>,<end>[<entry>]] 

SSYM; 

iEVT ) ( SELF \ 
evt+fullK')self+emuP^ 



I OFF I ( 



OFF 



TCMP[{' 



ADDR 
DATA 



Q0 



Ql 



(Q2 



Q3 



]:),Aq][HDB,K][{:}EMu] 



[,<low 16 va1ue>[,<1ow 16 mask>]])] 



TEVT[(<events>[,<de1ays>[ 

THLT; 

TINT( '<device name>') 



rNORMl^fEACHl^riNTln-,. 

'[iNV J^[edgeJ [extJ-'-'^ 
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TRUN; 
TTB(<index>) 

TTBH(<1ndex>, 



[1:I411«][I:M[I:M 

Pi in^' IHi 1 

_ y_jIAQ hJDBIN jJEMU 



TTRC (<^ 



y_jIAQ |_jDBIN JEMU I ^^^'^ ^^"^ ' 



USYM; 

VRFY('<access name>' [,<bias>]) 

WAIT(<number>) 
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APPENDIX H 
AMPL PROCEDURE AND FUNCTION LIBRARY 



AMPL software includes a library of procedures and functions described in this appendix. These 
procedures and functions are stored on the AMPL system diskette (part number 937745-0001) in a set 
of 1 7 files. Table H-1 lists the procedures and functions in the library, and the filename by which each is 
accessed. The filenames shown apply when the diskette is loaded in floppy disk unit 1. 

To use the procedure and function library, the user loads the diskette into either floppy disk unit and 
executes COPY command for each file. Floppy disk unit 1 (left-hand unit) is normally used; the 
filenames for floppy disk unit 2 begin with DSC2 instead of DSC. 

AMPL software executes the COPY command by reading the file, printing a message that identifies 
the procedure or function being defined, and storing the definition for subsequent use. When the name 
of the procedure has previously been defined as a procedure, the user may enter a DELE command to 
delete the procedure, and reenter the COPY command. Similarly, when the name of the function has 
previously been defined as a function, the user may enter a DELE command to delete the function, and 
reenter the COPY command. Any other type of name duplication (name previously defined as a 
variable or array, function name previously defined as a procedure, or procedure name previously 
defined as a function) requires that the user clear the symbol table with a CLR command, reenter the 
COPY commands previously entered, and redefine required variables, procedures, functions, and 
arrays. By entering the desired COPY commands early in the debug session, the user minimizes the 
problems of duplicate names. 

Some files contain a single procedure or function; others contain several procedure or function 
definitions. When a file contains more than one definition, a separate message identifies each 
procedure or function. Figures H-1 through H-17 show the listings of the procedure and function 
library files. Each listing begins with a set ofcomments that describe the procedure or function and the 
syntax used to call it. 

The comments are followed by the message that identifies the procedures or function, and the AMPL 
statements that define it. 

After a file has been read and processed, the user may call the procedure or function in accordance with 
the caUing information contained in the listing of the file. 

The following is an example of a COPY statement (TX990) to install procedures ESTAT and TSTAT: 

?COPY('DSC:STAT/PRC') Copy file DSC:STAT/PRC and install 

procedures ESTAT and TSTAT. 

The COPY statement to install the same procedures in a DXIO system is; 

?COPY ('.SSSYSLIB.AMPLSLIB.STAT') Copy file .S$SYSL1B.AMPL$LIB.STAT 

and install procedures ESTAT AND 
TSTAT. 
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The following is an example of a call to procedure EST AT: 



? ESTAT 
EMULATOR IS EXECUTING AN IDLE INSTRUCTION. 
EMULATOR TRACE BUFFER IS NOT FULL. 
EVENT CONDITIONS ARE NOT SATISFIED. 
ggflF BREAKPOINTS COUNTED. 

The largest file is that of the 14 debug procedures. Because of the size of this file (and the time required 
for copying it into the program) the message that describes the procedures and their use is on a separate 
file, shown in figure H-4. In a TX990 system, execute LIST80 to obtain additional coimcs. In a DXIO 
system, execute a Print File command to obtain additional copies. 
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TITLE: 
REVISION: 



HflRDWfiRE DEMONSTRATION TEST FOR HMPL HfiRIMJfiRE 
09/16/77 



flBSTRfiCT: 

THIS COPV FILE IS READ AS PART OF THE SVSTEM TEST OF 
AN AMPL HARDWARE FOR QUICK VERIFICATION THAT THE EMULATOR 
AND TRACE MODULES WORK CORRECTLV UNDER THE AMPL SOFTWARE. 

USAGE: 

THE OPERATOR PLACES THE DISKETTE OR CISC WITH THIS FILE ON 
IT INTO A DRIVE "N" AND INVOKES AMPL. THEN HE GIVES THE 
FOLLOWING COMMAND: 

COPV < ' DSCN ; AMPHOT/PRC ' > <RETURN> 

. . WHICH COPIES THIS FILE FROM A FLOPPV DISKETTE. 



OR: 



COPV<'DSeN. S*SVSLIB. AMPL*LIB. AMPHDT')<RETURN> 
. . WHICH COPIES THIS FILE FROM A HARD DISC. 



THE FILE DEFINES THE PROCEDURE "AMPHOT" AND INVOKES IT. 
REFER TO THE TEXT MESSAGES BELOW FOR OPERATIONAL DETAILS. 



NOTE: 



THIS PROCEDURE IS NOT A HARDWARE DIAGNOSTIC! 



NL; 'DEFINING PROCEDURE AMPHDT - PLEASE WAIT';!*. 
'LOCAL' PROC DEFINITION 



CLR<10> 
C = 0; 

FUNC MEtlTST <3, 1) BEGIN . MEMORY TEST FUNCTION 

FOR LOC 1 = ARG 1 TO ARQ 2 BV ARG 3 DO 8L0C 1 = LOC 1 
FOR LOC 1 = ARG 2 TO ARQ 1 BV - ARG 3, DO 

IF 9L0C 1 NE LOC 1 THEN RETURN -1 . . MEMORY ERROR 
RETURN . . MEMORY OK ! 
END 



PROC RESET BEGIN 
PC = 0100 
WP = 0ft0 
R0 = 
Rl = 1 
R2 = 2 
R3 = 3 
END 



. INITIALIZE CPU REGISTERS PROCEDURE 



FUNC ETST CI. 1) BEGIN 

IF PC NE 0106 OR EST NE ARQ 1 THEN RETURN -1 
IF EMT EQ 

THEN BEGIN . . 9980 ADDRESSES TRACED 
LOC 1 = 0105 
END; 
ELSE BEGIN . . 9900 ADDRESSES TRACED 
LOC 1 = 0104 
END; 
IF ETBO NE -2+<EMT-l>'»'3 

OR ETBCETBOJ NE 0100 OR ETB<ETBN> NE LOC 1 
THEN RETURN -1 
RETURN 
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END; 

FUNC TTST<3> BEGIN 

IF EST NE OR TST NE HRG 1 OR TTBN-TTBO+i NE HRQ 2 OR 
TTB<TTBO> NE »MOV R0, Rl# OR TTB<TTBN> NE flRG 3 
THEN RETURN -1 
RETURN e 
ENO> 



PROC flMPHDT <0, 1) BEGIN 



IF C 



EQ THEN BEGIN 
C:NX0' -EMULATOR INITIfiLIZfiTION TEST-'; f^lL 



NL 
NL; 
NL> 
NL; 
NL; 
NL; 
C = 



'PLEfiSE INITIALIZE THE EMULATOR WITH THE COMMAND ' 

EINT<"<EMULATOR NAME>">' 
THE EMULATOR NAME WILL PROBABLV BE "EMU" FOR THE' 
TXDS OPERATING SVSTEM OR "EM01" FOR THE DX/10 3. OS ' 
IF THE INITIALIZATION SUCCEEDS CONTINUE THE TEST BV ENTERING 

AMPHDT<RETURN>' 
1 



RETURN; 
END; 

IF C EQ 1 THEN BEGIN 

C:NX0; '-EMULATOR MEMORV SELECTION TEST-'; NL 

EUM=OFF 

ETM=OFF 

IF EUM NE OR ETM NE THEN BEGIN 

NL; '♦** ERROR: MEMORV SELECTION TEST FAILS'; 

RETURN 

END 
C = 2 
END; 

IF C EQ 2 THEN BEGIN 

C;NX0; '-EMULATOR USER MEMORV TEST <4K WORDS >-'; NL 

EUM = ON; 

IF MEMTSTC0, >2000-32> 32> THEN BEGIN 

C.NX0; '*** ERROR: EMULATOR USER MEMORV ERROR' 

RETURN 

END; 
. . PLACE A PROGRAM IN MEMORV 
00100 = #MOV R0, Rltt; 
90102 = #MOV Rl, R2tt; 
00104 = #MOV R2. R3«; 
00106 = #IDLE#; 
C = 3; 
END; 



IF C EQ 3 THEN BEGIN 

C:NX0; '-EMULATOR TRACE BUFFER MEMORV TEST <256 WORDS >- 

ETM = ON; 

IF MBITSTk'QFEOO. 0FFFE. 2> THEN BEGIN 

C:NX0; '*** ERROR: EMULATOR TRACE MEMORV FAILURE' 

RETURN; 

END; 
C = 4; 
END; 



-; fJL 



IF C EQ 4 THEN BEGIN 
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C:NXe; '-EMULATOR RUN TEST-'; NL 

ETM = OFF 

ETRC<OFF) 

ECMP<OFF> 

EEVT<INT) 

EBRK<OFF, OFF> 

RESET 

ERUN 

IF EST NE 9 THEN BEGIN 

C;NXe;'*** ERROR: EMULfiTOR EXECUTION FAILURE' 

RETURN 

END; 
C = 5 
END; 

IF C EQ 5 THEN BEGIN 

C;NXe; 'HEMULATOR HALT TEST-'; NL 

LOC 1 = EHLT 

IF EST NE e THEN BEGIN 

C:NXe;'*** ERROR: EMULATOR FAILED TO HALT PROPERLV 

RETURN 

EISK>; 
C = 6; 
END; 

IF C EQ 6 THEN BEGIN 

C:NX0; '-EMULATOR TRACE TEST'; M. 

ETRC<AODR+IAQ. 3*<<N0T EMT>+3). INT>; 

EBRK<FULL>SELF); 

RESET 

ERUN; 

IF ETST<2> THEN BEGIN 

LOC 1 = EHLT; 

C:NX0; '*** ERROR: EMULATOR FAILED TRACE TEST' 

RETURN; 

END; 
C = 7; 
END; 

IF C EQ 7 THEN BEGIN 

C:NX8; '-EMULATOR ADDRESS COMPARISON TEST-'; NL 

RESET; 

ECMP<IAQ>0ie4>; 

EEVT<INT>; 

EBRK<EVT, SELF>; 

ERUN; 

IF ETST<4> THEN BEGIN 

EHLT; 

C:NX0;'*** ERROR: EMULATOR FAILED PC BREAKPOINT' 

RETURN; 

END 
NL; '*♦♦ EMULATOR PASSES HARDWARE DEMONSTRATION TEST ♦♦*'; NL 
V = 9; N = -1; 
C:NX5;'D0 VOU WISH TO TEST A LOGIC STATE TRACE MODULE? <V^VES- N--NO> 
IF READ EQ 

THEN C = 8 

ELSE C = 14 
END; * 

IF C EQ 8 THEN BEGIN 

C:NX0; '-LOGIC STATE TRACE MODULE INITIALIZATION TEST-';NL 
NL; 'TO TEST THE AMPL LOGIC STATE TRACE MODULE IT MUST BE STRAPPED TO' 
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NL> 'THE EMULATOR JUST TESTED WITH BOTH THE CONTROL Rt-iO DfiTfi COBLES. 



NL 
NL; 
NL 



'PLEASE VERIFY THAT THESE CABLES ARE CONNECTED. 
'INITIALIZE THE LOGIC STATE TRACE MODULE WITH THE COMMAND 
TINT<"<TRACE MODULE NAME>" > 



NL 
NL^ 

NLj _, 

NL> 'THE TRACE MODULE NAME WILL PROBABLV BE "TRA" FOR THE' 



TXDS OPERATING SYSTEM OR "TMBl" FOR THE DX/10 S 8 OS ' 
'IF THE INITIALIZATION SUCCEEDS CONTINUE THE TEST BY ENTERING 

AMPHDT<RETURN>' 
C = 9 
RETURN; 
END> 



IF C EQ 9 THEN BEGIN 

C:NX0; '-TRACE MODULE INTERNAL CLOCK TEST-'; NL 

ECMP<OFF) PUT THE EMULATOR IN A NEUTRAL STATE 

EEVT<INT) 

ETRC<:OFF> 

EBRK<OFF, OFF) 

TTRC<OFF, 10, INT> OFF>; 

TEVT<1. 0, 0>; 

TBRKCFULL, SELF); 

TRUN; 

RESET; 

ERUN; LOC 1 = EHLT; 

IF TST NE 6 THEN BEGIN 

LOC 1 = EHLT; 

C:NX8; '*** ERROR: TRACE MODULE FAILED INTERNAL CLOCK TEST' 

RETURN 

END 
C = 10; 
END; 

IF C EQ 10 THEN BEGIN 

C:NX0; '-TRACE MODULE DATA TRACE TEST-'; NL 
TTRC<DATA+IAQ+<EMT-1)*Q0, 3, EXT); 
TBRK<FULL> EMU) 
TRUN; 
RESET; 

EBRK<OFF, SELF) 
ERUN; 

IF TTST<6> 3> #MOV R2, R3#) 
THEN BEGIN 

LOC 1 = EHLT; 

C:NX0; '*** ERROR: TRACE MODULE FAILED DATA TRACE' 

RETURN; 

END 
C = 11 
END; 

IF C EQ 11 THEN BEGIN 

C:NX0; '-TRACE MODULE EVENT TEST-'; NL 
TCMP<DATA+IAQ+<EMT-1)*Q0, #MOV R0, Rl#, >FFFF) 
TEVT<1. 0) 
TBRK<EVT> EMU) 
TRUN 
RESET 
ERUN 

IF TTST<4. 1, #MOV R0, Rl#) 
THEN BEGIN 

LOC 1 = EHLT 

C:NX0; '*** ERROR: TRACE MODULE EVENT FAILURE' 

RETURN 
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END; 
C = 12 
END 

IF C EQ 12 THEN BEGIN 

C;NX0'-TRfiCE MODULE: TRACE DELflV TEST-'; NL 
TEVT<1> 2> 
RESET 
TRUN 
ERUN 

IF TTST<4, 3, #MOV R2- R3#> 
THEN BEGIN 

LOC 1 = EHLT 

C.NXO; '*** ERROR: TRfiCE MODULE DELflV FAILURE' 

RETURN 

END 
C = 13 
END 

IF C EQ 13 THEN BEGIN 

NL; '*** TRACE MODULE PASSES HARDWARE DEMONSTRATION TEST ♦**'; NL 

C = 14 

END; 

IF C EQ 14 THEN BEGIN 

NL; •*** CONCLUSION OF AMPL HARDWARE DEMONSTRATION TEST ***'; NL 
C = 
END 
END 



AMPHDT INTRODUCTION 

BEGIN 

C = 

C;NX0; '*** INTRODUCTION: AMPL HARDWARE DEMONSTRATION TEST ***';NL 
NL; ' AMPHDT IS AN AMPL PROCEDURE TO VERIFV THE CORRECT OPERATION" 
NL; ' OF THE EMULATOR AND LOGIC STATE TRACE MODULES. ' 

C:NX5'0NLV A QO/NC GO TEST IS PERFORMED. '; NL 

C:NX0;'**>t« THIS IS NOT A HARDWARE DIAGNOSTIC TEST •♦**'; NL 

C:NX5;'TVPE C<RETURN> FOLLOW I Na THE "=?" TO CONTINUE ' 

C = READ 
NL; ' TO TEST THE TRACE MODULE. AN EMULATOR MUST BE PRESENT AND 
NL; -CONNECTED WITH THE DATA AND CONTROL CABLES TO THE TRACE MODULE. ' 
NL; ' TO TEST THE EMULATOR, A BUFFER MODULE < EITHER THE TMS9900 ' 
NL; 'OR TMS9980> SHOULD BE CONNECTED TO THE EMULATOR MODULE. THE CLOCK 
NL; 'SELECT SWITCH ON THE BUFFER MODULE MUST BE SET TO "INTERNAL". ' 
NL; 'THE TARGET MICROPROCESSOR CONNECTOR CABLES FROM THE' 
NL; 'BUFFER MODULE SHOULD NOT BE PLUGGED INTO A TARGET SYSTEM. ' 
NL; 'REFER TO SECTION 2. 2. 3 OF THE AMPL SYSTEM OPERATION GUIDE' 
NL; 'C #946244-9701 > FOR DETAILS OF THESE CONNECTIONS. ' 

C:NX5;'TVPE C<RETURN> FOLLOWING THE "=?" TO CONTINUE' 

C = READ 
NL. ' THE TITLE OF EACH TEST IS PRINTED AS IT IS PERFORMED. ' 
NL; 'FAILURE OF THE TEST WILL RESULT IF AMPL DETECTS AN ERROR' 
NL; 'OR INCORRECT RESULTS ARE DETECTED BY THE TEST PROCEDURE. 
NL; 'IN EITHER CASE A tJESSAGE WILL BE PRINTED AND THE TEST ABORTED. 
NL; 'YOU MAY RETRY THE TEST THAT JUST FAILED BY ENTERING:' 
NL; ' AMPHDT<RETURN> ..FOLLOWING "?"' 

NL. 'THE COMPLETE TEST PASSES ONLY IF NO ERRORS ARE' DETECTED. ' 

C:NX5; 'TYPE CCRETURN> FOLLOWING THE "=^?" TO CONTINUE' 
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C = REflO 

END 

fll«>HDT 
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TITLE. 
REVISION: 



ftSRKSR : 
03/24/77 



ROUTINES TO USE AN flSR OR KSR TERMINAL 



RBSTRRCT ■ 

THREE ROUTINES RRE CONTAINED IN THIS FILE. THEV INTERACT WITH 
. . . EITHER AN RSR733 OR A KSR743 TERMINAL CONNECTED TO THE TARGET 
, . . SVSTEM. THE INITRM PROCEDURE INITIALIZES THE INTERFACE LOGIC AT 
. . . THE SPECIFIED CRU BASE ADDRESS. GETCHR AND PUTCHR READ AND WRITE 
...A SINGLE ASCII CHARACTER, RESPECTIVELY, ONCE INITRM HAS BEEN CALLED. 

. . . USAGE : 

INITRM HAS ONE ARGUMENT, THE CRU BASE ADDRESS. IF THIS 
. , . IS OMITTED, CRU BASE ZERO IS USED. INITRM LEAVES SVSTEM VARIABLE 
. . . CRUB SET TO THE CRU BASE OF THE DEVICE, SO PUTCHR AND GETCHR CAN 
. . . USE IT. INITRM MAV BE CALLED ONLV WHEN THE EMULATOR IS HALTED. 
. . . GETCHR READS ONE CHARACTER FROM THE DEVICE INTERFACE AT THE BASE 
. . . ADDRESS IN SVSTEM VARIABLE CRUB. GETCHR HAS NO ARGUMENTS AND 
. . . RETURNS THE ASCII CODE FOR THE CHARACTER TVPED. GETCHR DOES NOT 
. . . RETURN UNTIL A CHARACTER IS TVPED ON THE TERMINAL. GETCHR MAV BE 
. . . CALLED ONLV WHEN THE EMULATOR IS HALTED. 

. . . PUTCHR WRITES ITS ONE ARGUMENT ON THE DEVICE INTERFACE AT THE BASE 
. . . ADDRESS IN SVSTEM VARIABLE CRUB. PUTCHR IS A PROCEDURE AND DOES 
. . . NOT RETURN A VALUE. PUTCHR MAV BE CALLED ONLV WHEN THE EMULATOR 
. . . IS HALTED. 

DEFINING INITRM' 



PROC INITRMC0) BEGIN 

IF ARG 

THEN CRUB = ARG 1 
ELSE CRUB = 0i 

CRUWC09, 1, 1>; 

CRUW<0fl, 1, 1>> 

CRUWCOB,!, 1>> 

CRUW<.0C, 1, l>.i 

CRUWOE, 1, 0>; 

CRUWC0F, 1, 0>; 
END 



BASE ADDRESS WAS SPECIFIED 
NOT SPECIFIED 
SET DATA TERMINAL READV 
SET REQUEST TO SEND 
CLEAR WRITE REQUEST 
CLEAR READ REQUEST 
DISABLE INTERRUPTS 
DISABLE DIAGNOSTIC MODE 



NL 

'DEFINING FUNCTION GETCHR' 



FUNC GETCHR <0, 1> BEGIN 

REPEAT NULL UNTIL CRUR<:0C, 1>; 

LOC 1 = •CRUR<0, 8>i 

CRUWC0C, l,l>i 

RETURN LOC li 
END 



WAIT UNTIL READ REQUEST 
READ THE CHARACTER 
CLEAR READ REQUEST 
RETURN CHARACTER 



NL 

'DEFINING PUTCHR' 



PROC PUTCHR <!> BEGIN 

REPEAT NULL UNTIL CRUR<QE, 1>j 

CRUWCO, 8, ARG l)i 

REPEAT NULL UNTIL CRUROB, l>i 

CRUW<0B, 1, l>i 
END 



WAIT UNTIL DATA SET READV 
SEND THE CHARACTER 
WAIT ON WRITE REQUEST FINISHED 
CLEAR WRITE REQUEST 
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TITLE: SIMPLE DEBUG COflMHNDS 

REVISION: Q9/27/77 

HBSTRflCT : 

THIS SET OF flMPL FUNCTIONS AND PROCEDURES IMPLEMENTS 
H SMfiLL fiND SIMPLE SET OF COMMANDS FOR THE USER TO DEBUG ft 
PROTOTYPE SVSTEM. THE COMMANDS ARE GROUPED INTO THREE BASIC 
COMMAND CLASSES: 

1) EMULATION CONTROL; <LOADUP. RUN, HALT> 

LOAD MEMORY/ RUN AND HALT THE EMULATOR 

2> TARGET SVSTEM STATUS: <STAT, DR, DT> 

CURRENT EMULATION STATUS, REGISTERS AND TRACE BUFFER 

3 ) TRflCE/BRE AKPO I NT SPEC I F I CAT I ON : < TRACE, T I LL, VALUE, AT, DELA V ) 
USER SELECTION OF WHAT TO TRACE AND WHEN 
TO HALT THE EMULATION 

THE USER MAV OBTAIN A LIST OF THESE COMMANDS AND THE SYNTAX FOR 
THEIR ARGUMENTS AT ANY TIME BY USE OF THE 'HELP' COMMAND. 

>t<>K>«c>«<* IMPORTANT NOTE: 

THIS SET OF DEBUG COMMANDS PRESUMES THE FOLLOWING 
CONFIGURATION OF THE AMPL HARDWARE: 

- THERE IS ONE EMULATOR MODULE AND ONE TRACE MODULE 
< NAMED EMei AND TM01>. 

- THE EMULATOR AND TRACE MODULE ARE 'STRAPPED' TOGETHER 
WITH THE DATA AND CONTROL CABLES. 

- THE USER HAS A 911 VDT CONSOLE FOR INTERACTIVE USE. 

COMPLETE USER DOCUMENTATION OF THE DEBUG COMMANDS IS AVAILABLE ON 
FILE: DEBUG/DOC <FS990> OR . S*SYSLIB. AMPL*LIB. DEBUGDOC CDX/IQ 3. e> 

.♦He*************************************************************!!.******** 

NL 

"DEBUG COMMANDS'" 

ARRAY 2DBG<9> 



NL 

'DEFINING: HELP' 

PROC HELP<0, 1) BEGIN 
NL 

'EMULATOR CONTROL COMMANDS:' 
LOC 1:NX5; 'LOADUP C <: "FILENAME'T, BIASC, EUM] 3> ]' 

' - INITIALIZE AND LOAD TARGET' 
LOC 1:NX5; 'RUN KPCi.UPl-)! - RUN THE TARGET SYSTEM' 
LOC 1:NX5; 'HALT - HALT THE TARGET SYSTEM' 

NL;NL 

'TARGET SYSTEM STATUS:' 

LOC l:NX5i'STAT - TARGET SYSTEM STATUS' 

LOC 1:NX5j'DR - DISPLAY REGISTERS' 

LOC 1:NX5; 'DT C CFIRSTC, LAST ]> 3 - DISPLAY TRACE' 

NL;NL 

'TRACE SPECIFICATION:' 
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LOC 1 : NXS; ' TRfiCE C <COUNTC . QUflL 3> D' 

LOC l:NX0i 'COUNT: Q. . 256 <0=INFINITV>, QUflL: IftQ> DBIN- -DBIN' 



NL-f*. 

' BREftKPO INT SPEC I F I CAT I ON : ' 

LOC 1:NX5; ' TILL C <COUNT> 3 COUNT; 1. . >FFFF ' 

LOC 1:NX5;' MREflD, MWRITE> OR INSTR CHOOSE ONE OR NONE' 

LOC 1:NX3;' VALUE <DflTflt . MASK 3> DEFAULT MASK IS >FFFF' 

LOC 1;NX5;' AT CADDRJ' 

LOC 1:NX5;' DELAV < COUNT) COUNT: 1. . 256' 

END 



PROC TRACE NULL . . DUMMY TRACE PROCEDURE 

PROC STAT NULL . . DUMMY STAT PROCEDURE 

NL 

'DEFINING: LOADUP C <"FILENAME"t , BIASC, EUM33> 3' 

PROC LOADUP <0, 1> BEGIN 

NLi 'TX OR DX ? <0=TX. 1=DX>' 
IF READ THEN BEGIN 
EINT<'Eri01') 
TINT<'TM01'> 
END 
ELSE BEGIN 

EINTC'EMU'> 
TINT<'TRA'> 
END 
ETM=OFF 
.. INITIALIZE EMULATOR USER MEMORY 
IF ARG GE 3 

THEN EUM = ARG 3 

ELSE EUM = ON . . DEFAULT TO EMULATOR MEMORY ENABLED 
. . LOAD THE USERS PROGRAM 
IF ARG GE 1 THEN BEGIN 

LOC 1 = >A0 . . DEFAULT LOAD BIAS 
IF ARG GE 2 THEN LOC 1 = ARG 2 
LOAD<ARG 1, LOC 1> 
WP = (?LOC 1 
PC = e<LOC 1 +2) 
END 
. . INITIALIZE TRACING 
TRACE 

STAT 

END 



NL 

'DEFINING: RUN C (PC CWP] > 3' 

PROC RUN BEGIN 
TRUN 

IF ARG GE 1 THEN PC=ARG 1 
IF ARG GE 2 THEN WP=ARQ 2 
ERUN 
STAT 
END 
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NL 

'DEFINING: HfiLT' 

PROC HOLT BEGIN 
EHLT:X 
THLT;X 
STRT 
END 



.TITLE; STflT 
. . REV I S I ON : 98/30/77 

f^BSTRflCT ■ 

STfiT USES SYSTEM VfiRIflBLES EST. TNE, ETBO. AND EUM TO PRINT 
. . THE STRTUS OF THE EMULATOR AND THE DEBUG SETUP. 

. . USAGE : 

STAT HAS NO ARGUMENTS AND MAV BE CALLED AT ANV TIME. 

DELE < 'STAT' > 

PROC TQUAL CASE 2DBQ<2>-DATA OF 
: : ' MEMORV CVCLES' 
lAQ : : ' INSTRUCTION ACQUISITIONS' 
D8IN . ; ' READ MEMORV CYCLES' 
-DBIN : : ' WRITE MEMORV CYCLES' 
END 

NL 

'DEFINING: STAT' 

PROC STAT <0. 1) BEGIN 

LOC 1 = <EST AND 1> EQ 

'. '. EMULATION CONTROL 

NL; 'EMULATION CONTROL :'; LOC 1 : NXS; 
IF LOC 1 THEN BEGIN 
'HALTED' 

IF EUM THEN ' < EMULATOR USER MEMORV Et^lABLED)' 
1-ETB0:N2X5D; 'SAMPLES TRACED:' 
IF TTBO LE TTBN THEN BEGIN 
TTBO:D; '. . '; TTBN:D; 
END; 
TNE:NX5U; 'EVENTS COUNTED. ' 
NL;DR 
END 
ELSE BEGIN 

'RUNNING' 

IF EST AND 8 THEN ' AT IDLE' 

END 

. . DEBUG CONFIGURATION 

NL;NL; 'DEBUG CONFIGURATION: '; LOC 1 : NX5; 

'TRACE: ' 

IF ZDBG<1> NE TrtEN ZDBG<1>:D 

ELSE ' ALL'; 
TQUAL 
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IF ZDBQC9) RND EVT THEN BEGIN 

NLi ' TILL: ' 2DBG < 3 ) : DNX5 
CASE <2DBG<4> - DflTfl> OF 

8 : ; 'MEMORY CYCLE' 

IRQ :: 'INSTRUCTION fiCQUISITION' 

DBIN-IfiQ : : 'MEMORY REfiD' 

-DBIN : : 'MEMORY WRITE' 

END 
IF ZDBQ<6) NE THEN BEGIN 

' VALUE: ';ZDBG<5> 

IF 2DBQ<6> NE -X THEN BEGIN 
' MASK: ' ZDBQ<6>:H 
END 

END 
IF ZDBG<7) NE 0FFFF THEN BEGIN 

' AT ADDRESS: '; ZDBG<7>; 

END 
IF 2DBQ<8> NE THEN BEGIN 

NLj ' DELAY : ' ; ZDBG < 8 ) : D; TQURL; 

END 
END 

END 



NL 

'DEFINING: DT C <FIRSTC, LAST3> 3' 

PROC DT<0, 4) BEGIN 
NL. 

' INDEX ADDR 
NL; 

LOG 2 = TTBN-19; 

IF LOC 2 LT TTBO THEN LOC 2 = TTBO 

LOC 3 = TTBN 



D ATA < HEX, ASC II) I NTERPRETAT I ON ' ; 

. . LOC 2 IS TRA LOWER INDEX 
. . LOC 3 IS TRA UPPER INDEX 

. . SET TRA LOWER INDEX 



IF ARG GE 1 

THEN IF ARG 1 GE TTBO AND ARG 1 LE TTBN 
THEN LOC 2 = ARG 1 
IF ARG GE 2 

THEN IF ARG 2 GE LOC 2 AND ARG 2 LE TTBN 
THEN LOC 3 = ARG 2; 
LOC 1 = ETBO + LOC 2 - TTBO 



SET TRA UPPER INDEX 



ADJUST EMU INDEX 



WHILE LOC 2 LE LOC 3 
DO BEGIN 

LOC 2:NDX3; ..PRINT INDEX IN TRACE BUFFER 

IF LOC 1 GE ETBO AND LOC 1 LE ETBN 

THEN ETB<LOC 1):H .. PRINT TRACED ADDRESS IN HEX 
ELSE ' '; 
TTBCLOC 2):X4HA; ..PRINT TRACED VALUE IN HEx/aSCII 

IF TTBH<LOC 2, lAQ) 

THEN TTB<LOC 2>:X6I ..DISPLAY THE INSTRUCTION 
ELSE BEGIN , . ITS A DATA ACCESS 

IF TTBH<LOC 2, DBIN) 

THEN ' READ ' ... IT'S A READ 

ELSE ' WRITE '; . . IT'S A WRITE 

TTB<LOC 2):H; ... DISPLAY THE DATA 
END> 
LOC 2 = LOC 2 + 1; ... STEP TTB INDEX 

LOC 1 = LOC 1 + 1; ... STEP ETB INDEX 
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END 



END 



DELE <' TRACE') 

NL 

'DEFINING: TRfiCE C <COUNTt , QUflL]> 3' 



PROC TRACE <0) BEGIN 

. . INITIALIZE THE DEFAULT STATE 

2DBG<1> =0 . . TRACE COUNT 



ZDBG<2> 


SZ 


DATA 


ZDBG<3> 


s 


1 


ZDBG<4) 


s: 


DATA 


ZDBGCS) 


= 


e 


ZDBG<6> 


= 





2DBG<7) 


= 


eFFFF 


ZDBG<8> 


5= 


e 


ZDBG<9> 


S 


OFF 



. TRACE QUALIFIER 

. EVENT COUNT 

. BUS CONTROL QUALIFIER 

. DATA BUS COMPARISON VALUE 

. DATA BUS COMPARISON MASK 

. ADDRESS BUS COMPARISON VALUE 

. TRACE DELAY COUNT 

. HALTING CONDITIONS 



INITIALIZE AHPL HARDWARE PROCEDURES 



ETRC<ADDR. 236. EXT> 

ECMP<IAQ, 0FFFF> 

EEVT<INT> 

EBRK<OFF, SELF> 

TTRC<;DATA> 0. EXT) 

TCMPCDATA+IAQ-DBIN, 0. 0, OFF) . . TM DATA COMPARISON. NO LATCHES 

. TM EVENT COUNTER 

. STOP EMULATOR IF BREAKPOINT DEFINED 



TRACE ADDRESS IN THE EMULATOR 
NO EMULATOR ADDRESS COMPARISON 
BUT WILL USE COMPARISON IF SELECTED 
TRACE MODULE MAV HALT THE EMULATOR 



TRACE QUALIFIER 
CMPR QUALIFIER 



TEVT<1. 0, INT+NORM+EACH) 
TBRK<OFF. EMU) 
CHECK FOR TRACE PROCEDURE ARGUMENTS 
IF ARC Q£ 2 THEN BEGIN 

ZDBQ<2> = ZDBG<2)+ARG 2 
ZDBG<4) = DATA+ARG 
END 
IF ARQ QE 1 THEN IF ARC 1 NE THEN BEGIN 

ZDBG<1) = ARG 1 . . TRACE COUNT 
ZDBGO) = FULL . . BREAK ON TRACE BUFFER FULL 
END 
INITIALIZE 'TTRC 
TTRCC2DBG<2)+<EMT-1)*Q0> ZDBG<1). EXT) 
TBRK< ZDBGO)) 



END 



NL 
DEFINING: 



TILL C <COUNT) 3' ' 



EVENT COUNTER 



PROC TILL >:0) BEGIN 

. . CHECK FOR OPTIONAL ARGUMENT 
IF ARG GE 1 THEN BEGIN 
ZDBQ<3) = ARG 1 
TEVT<ZDBG<3)) 
END 
. . HALT ON AN EVENT C DEFAULT TO SAME AS TRACING) 
TCMP<ZDBG<4)) 
ZDBGO) = ZDBGO) + EVT 
TBRK<: ZDBGO)) 



END 



Figure H-3. Listing of DEBUG Procedure File (Sheet 5 of 6) 



HI 7 



Digital Systems Division 




946244-9701 



NL 

[>EFINI^4G; MREflO> MWRITE, INSTR' 
PROC MREflD BEGIN 

ZDBG<4) = DflTfl+DBIN-IRQ 

TCMP<2DBG<4)> 

END 



LOOK FOR MEMORV READ 



PROC MWRITE BEGIN 

ZDBQ<4> = DflTfl-DBIN 

TCMP<ZDBG<4>> 

END 



LOOK FOR MEMORV WRITE 



PROC INSTR BEGIN 

ZD8G<4> = DflTfl+IfiQ 

TCMP<2DBG<4>> 

END 



. LOOK FOR INSTRUCTION HCQUISITON 



NL 
DEFINING: VALUE <DfiTflC, MHSK]> ' 

PROC VfiLUE <1) BEGIN 

CHECK FOR OPTIONflL ARGUMENT 
IF flRG GE 2 THEN ZDBG<6> = RRG 2 . . TM COMPARISON MASK 
ELSE ZDBQ<:6> = -1 . . DEFAULT MASK 
INITIALIZE TRACE MODULE COMPARATOR 
ZDBG<5) = ARQ 1 . . TM COMPARISON DATA VALUE 
TCMP<ZDBG<4>, ZDBG<5>, ZDBQ<S>> 

END 



NL 
DEFINING: AT <ADDR)' 

PROC AT <1> BEGIN 

INITIALIZE EMULATOR COMPARATOR 
ZDBQ<7> = ARG 1 

ECMP<ADDR> ARG 1 OR <1-EMTJ> 
TCMP < ZDBG < 4 > +EMU ) 



END 



NL 

'DEFINING: DELAV <! COUNT V 

PROC DELAV CIJ BEGIN 

. . INITIALIZE EVENT DELAV 

2DBG<8) = ARG 1 . . EVENT DELAV 
TEVT<:2DBG<3>. ARG i-> 



END 
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TITLE: SIMPLE DEBUG COMMRNDS < DOCUMENTATION) 
REVISION: ^03/2.7/77 

flBSTRflCT ' 

THIS SET OF flMPL FUNCTIONS 8N0 PROCEDURES IMPLEMENTS 
fl SMfiLL. SI MPLE> UNIFORM SET OF COMMfiNDS FOR THE USER TO DEBUG H 
PROTOTYPE SYSTEM. THE COMMANDS ARE GROUPED INTO THREE BASIC 
COMMAND CLASSES; 

1> EMULATION CONTROL: <LOADUP> RUN. HALT> 

LOAD MEMORY, RUN AND HALT THE EMULATOR 

2> TARGET SYSTEM STATUS: <STAT, DR> DT> 

CURRENT EMULATION STATUS- REGISTERS AND TRACE BUFFER 

3> TRACE/BREAKPOINT SPECIFICATION: (TRACE, TILL, VALUE, AT> DELAY) 
USER SELECTION OF WHAT TO TRACE AND WHEN 
TO HALT THE EMULATION 

THE USER MAY OBTAIN A LIST OF THESE COMMANDS AND THE SYNTAX FOR 
THEIR ARGUMENTS AT ANY TIME BY USE OF THE 'HELP' COtWIAND. 

«>t<>«<>i<>f IMPORTANT NOTE: 

THIS SET OF DEBUG COMMANDS PRESUMES THE FOLLOWING 
CONFIGURATION OF THE AMPL HARDWARE: 

- THERE IS ONE EMULATOR MODULE AND ONE TRACE MODULE 

< NAMED EM01 AND TM01). 

- THE EMULATOR AND TRACE MODULE ARE 'STRAPPED' TOGETHER 

WITH THE DATA AND CONTROL CABLES. 

- THE USER HAS A 911 VDT CONSOLE FOR INTERACTIVE USE. 

THIS IS THE USER DOCUMENTATION FOR THE ABOVE COMMANDS. THE COMMANDS 
ARE DEFINED ON: DEBUQ/PRC <FS99e) OR 

. S*SYSLIB. AMPL«LIB. DEBUG <DX 3. 9) 

************************************************************************** 

HELP COMMAND: 

DISPLAY THE SYNTAX OF THE DEBUG COMMANDS. 

EXAMPLE DISPLAY: 

EMULATOR CONTROL COMMANDS: 

LOADUP C<'FILENAME'C,BIASC,EUM:])3 - INITIALIZE AND LOAD TARGET RY 
RUN C<PCC,WP3)3 - RUN THE TARGET SYSTEM 
HALT - HALT THE TARGET SYSTEM 

TARGET SYSTEM STATUS: 

STAT - TARGET SYSTEM STATUS 

DR - DISPLAY REGISTERS 

DT C<FIRSTC,LAST])] - DISPLAY TRACE 

TRACE SPECIFICATION: 

TRACE C CCOUNTC , QUAL 3) 3 

COUNT: 0. . 256 <0=INFINITV), QUAL: lAQ, DBIN, -DBIN 

BREAKPOINT SPECIFICATION: 

TILL CC COUNT) 3 COUNT: 1. . >FFFF 

MREAD, MWRITE, OR INSTR CHOOSE ONE OR NONE 

VALUE <;DATAC,MASK3) DEFAULT MASK IS >FFFF 
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ftT <flODR> 

DELflV < COUNT) COUNT: 1. . 256 

EMULATOR CONTROL. 

LOAD ftND INITIALIZE EMULATOR MEMORV 

INITIALIZE THE EMULATOR AND LOGIC STATE TRACE MODULES. 
TRANSFER AN OBJECT FILE INTO MEMORV OF THE TARGET 
SVSTEM AND INITIALIZE THE UP AND PC REGISTERS. 

LOADUP C<'FILENAME'C>BIASC.EUM3]>]' 

'FILENAME' - MUST BE AN OBJECT MODULE. THE STANDARD TI 

OPERATING SVSTEM INTERFACE IS EXPECTED IN THE OBJECT 
MODULE - THE FIRST TWO WORDS ARE THE WORKSPACE POINTER 
AND INITIAL PROGRAM COUNTER RESPECT I VELV. THE WORKSPACE 
POINTER <WP> AND PROGRAM COUNTER CPO ARE INITIALIZED 
TO THESE VALUES. 

BIAS - IS AN ADDRESS BV WHICH TO RELOCATE THE OBJECT MODULE. 
THE DEFAULT BIAS IS >A0. 

EUM - SELECTS 'EMULATOR USER MEMORV, A 4K WORD < ADDRESSES 

THROUGH >1FFF) BLOCK OF MEMORV ON THE EMULATOR MODULE. 
'ON' WILL CAUSE THE TARGET SVSTEM TO USE THE EMULATOR 
MODULE MEMORV IN THIS ADDRESS RANGE. 'OFF' WILL ALLOW 
THE TARGET SVSTEM TO ADDRESS ITS OWN MEMORV IN THE ADDRESS 
RANGE >00e0 THROUGH >1FFF. THE DEFAULT VALUE OF EUM IS 
'ON' <USE EMULATOR USER MEMORV). 



RUN EMULATION 

BEGIN EXECUTION IN THE TARGET SVSTEM WITH THE CURRENT 
WORKSPACE AND PROGRAM COUNTER IF NOT SPECIFIED IN THE 
COMMAND. 

RUN C<PC C>WP3)3 



HALT EMULATION 

STOP EMULATION IN THE TARGET SVSTEM. A 'STAT' COMMAND 
IS ALSO PERFORMED. 

HALT 



TARGET SVSTEM STATUS: 
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EMULATION STATUS 

DISPLflV INFORMATION CONCERNING THE CURRENT STATUS OF 
THE TARGET SVSTEM -.'EMULATION CONTROL), AND THE 
TRACE/BREAKPOINT SELECTION < DEBUG CONFIGURATION). 

STAT 
EXAMPLE DISPLAV. 



EMULATION CONTROL: 

HALTED < EMULATOR USER MEMORY ENABLED) 



256 SAMPLES TRACED; 
2 EVENTS COUNTED. 



-255 







Re 


= 


>FFFF 


R8 


= 


>1C45 


PC 


sz 


>0132 


/ >0601 


DEC 


Rl 


Rl 


= 


>0FE6 


R9 


= 


>1C44 


UP 


= 


>0138 








R2 


= 




R10 


= 


>1444 


ST 


= 


>D20e 








R3 


= 


>0000 


Rli 


= 


>010E 














R4 


= 


>1C45 


R12 


s 


>1FE0 














R5 


= 


>1C44 


R13 


= 


>1844 














R6 


= 


>1C45 


R14 


= 


>1845 














R7 


s 


>1444 


R15 


= 


>1800 















DEBUG CONFIGURATION; 

TRACE; ALL MEMORV CVCLES 

TILL; 2 

INSTRUCTION ACQUISITION AT ADDRESS: >0106 

DELAV: 123 flEMORV CVCLES 



DISPLAV THE WORKSPACE REGISTERS 

DISPLAV THE CURRENT VALUE OF THE PROGRAM COUNTER, 
THE WORKSPACE, AND THE VALUES OF THE WORKSPACE 
REGISTERS THIS INFORMATION IS ALSO INCLUDED IN THE STAT 
COMMAND. THIS COMMAND MAY ONLV BE USED WHEN THE 
EMULATOR IS NOT EXECUTING. 

DR 

EXAMPLE DISPLAV: 



RO 


= 


>FFFF 


R8 


S 


>iC45 


PC 


= >0132 / 


Rl 


= 


>0FE6 


R9 


= 


>1C44 


WP 


= >0138 


R2 


=: 


>0000 


R10 


3= 


>1444 


ST 


= >D20e 


R3 


= 


!/0000 


Rll 


:s 


>010E 






R4 


= 


>1C45 


R12 


= 


>1FE0 






R5 


= 


>1C44 


R13 


S= 


>1844 






R6 


= 


>1C45 


R14 


= 


>1S45 






R7 




>1444 


R15 


= 


>i800 







>0601 DEC Rl 



DISPLAV THE TRACE BUFFER 
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DISPLfiV HND INTERPRET THE TRACE SINCE THE LAST RUf^. 

EACH SAMPLE OF THE TRACE BUFFER CONSISTS OF THE ADDRESS BUS/ 
DATA BUS> AND BUS CONTROL LINES. THIS INFORMATION IS 
DISPLAYED ALONG WITH THE INDEX INTO THE BUFFER ALONG THE 
LEFT HAND SIDE. THE NUMBER OF SAMPLES TRACE IS GIVEN 
BV THE 'STAT' COMMAND. THIS COMMAND MAV ONLV BE USED WHEN 
THE EMULATOR IS NOT EXECUTING. 

DT C<FIRSTC> LAST 3)3 

NO ARGUMENTS WILL DISPLAV THE LAST 20 SAMPLES TAKEN. 
ONLV ONE ARGUMENT WILL DISPLAV 20 SAMPLES BEGINNING 

WITH THE THE ARGUMENT SPECIFIED. 
TWO ARGUMENTS DISPLAYS THE TRACE BETWEEN THE TWO INDICES. 

EXAI«>LE DISPLAV: 

INDEX ADDR DATA <HEX> ASCII) INTERPRETATION 



12 


>0132 


>0601 




DEC 


Rl 


11 


>013A 


>0002 






READ >0002 


10 


>013A 


>0e01 






WRITE >8e01 


-9 


>0134 


>16FE 


'^ 


JNE 


*->0002 


-8 


>0132 


>0601 




DEC 


Rl 


-7 


>013A 


>0001 






READ >0001 


-6 


>013A 


>0000 






WRITE >0000 


-5 


>0134 


>16FE 


^ 


JNE 


«->0002 


-4 


>0136 


>045B 


c 


RT 




-3 


>014E 


>ei20 






READ >0128 


-2 


>0120 


>10F2 


R 




READ >10F2 


-1 


>0120 


>10F2 


R 


JMP 


*->001A 


e 


>ai06 


>0200 




LI 


R0< >0000 


1 


>0108 


>FFFF 






READ >FFFF 


2 


>0138 


>FFFF 






WRITE >FFFF 


3 


>010A 


>0£A0 




BL 


e>0000 


4 


>010C 


>ei22 


•1 




READ >0122 


5 


>0122 


>020C 






READ >620C 


6 


>014E 


>0ieE 






WRITE >010E 


7 


>0122 


>020C 




LI 


R12. >000e 



****************************** ll.******************************************* 



TRACE/BREAKPO I NT SELECT I ON : 

THIS SET OF DEBUG COMMANDS ALLOWS THE USER TO QUICKLY SPECIFY 

- WHAT TO TRACE. 

- A MAXIMUM NUMBER OF TRACE SAMPLES DESIRED. 

- THE NUMBER OF 'EVENTS' TO COUNT BEFORE GENERATING A 'BREAKPOINT' 

CONDITION. 

- WHAT CONSTITUTES AN 'EVENT'. 

- THE NUMBER OF SAMPLES TO TAKE AFTER 'BREAKPOINT' 

BEFORE ACTUALLY HALTING THE EMULATOR. 

WHERE AN 'EVENT' IS DEFINED AS THE SUCCESSFUL MATCHING OF A 



BUS VALUE AND^OR 
'EVENT- IS RN 
MEMORY WRITE 



USER SPECIFIED DATA BUS VALUE AtilD/OR ADORES 

BUS CONTROL QUALIFIER. FOR EXAMPLE A TYPICAL 

INSTRUCTION ACQUISITION AT ADDRESS >i.0e OR A 

OF DATA VALUE >1A AT ADDRESS >230. 

AFTER 'N' NUMBER OF SUCH EVENTS HAVE OCCURED A 'BREAKPOINT' 

CONDITION IS GENERATED. THE 'BREAKPOINT' SIGNAL REQUESTS THE 

EMULATOR TO HALT EXECUTION FOLLOWING COMPLETION OF THE CURRENTLY 
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EXECUTING INSTRUCTION. FlLTERNfiTIVELV, THIS HfiLTING ACTION HftV 
BE 'DELflVED' UNTIL fl USER SPECIFIED NUMBER OF flODTIONRL TRHCE 
SAMPLES HAVE BEEN TAKEN. FOR EXAMPLE, THE NEXT 180 INSTRUCTIONS 
FOLLOWING THE 'BREAKPOINT' CONDITION. 

THE COMMANDS DEFINED HERE REPLACE THE AMPL EMULATOR/TRACE MODULE 
USER INTERFACE WITH A SIMPLE, Ur^IFORM VET POWERFULL COMMAND SET. 



TRACE SPECIFICATION: 



SPECIFV WHAT IS TO BE TRACE AND HOW MANV BEFORE HALTING 
THE EMULATION. THIS COMMAND MAV ONLV BE USED WHEN THE 
EMULATION IS HALTED AND MUST BE STATED BEFORE USE OF 
ANV OF THE BREAKPOINT SPECIFICATION COMMANDS. 

TRACE C <COUNT C , QUAL 3) 3 

IF NO ARGUMENTS ARE SPECIFIED ALL MEMORV CVCLES ARE TRACED. 

THE COUNT ARGUMENT INDICATES THE NUMBER OF TRACE SAMPLES 
TO TAKE BEFORE EMULATION IS HALTED. THE VALUE MAV 
BE FROM TO 256. THE VALUE 8 INDICATES irJFINITV - DO 
NOT HALT EMULATION <THE DEFAULT VALUE). 

THE QUAL ARGUMENT MUST BE: lAQ, DBIN, OR -DBIN TO SPECIFV 
TRACING ALL INSTRUCTION ACQUISITIONS, ALL READ CVCLES, OR 
ALL WRITE CVCLES RESPECT I VELV. LEAVING THIS ARGUMENT OUT 
DEFAULTS THE TRACE SAMPLES TO ALL MEMORV CVCLES 
< INSTRUCTION ACQUISITIONS, READ AND WRITE CVCLES >. 



BREAKPO I NT SPEC I F I CATON : 

AN EVENT IS DEFINED AS A SPECIFIC TVPE OF MEMORV CVCLE, 

WITH A PARTICULAR DATA VALUE, AT A DEFINITE ADDRESS. 
A BREAKPOINT OCCURS AFTER N NUMBER OF EVENTS HAVE OCCURED. 



TILL 



THE TILL COMMAND SPECIFIES THAT AN EVENT IS BEING DEFINED. 
IF NO OTHER EVENT SPECIFICATION IS DONE THE DEFAULT EVENT 
IS ANV MEMORV CVCLE. 

TILL C<C0UNT>3 

COUNT - THE NUMBER OF EVENTS BEFORE A BREAKPOINT IS GENERATED. 
THE DEFAULT VALUE IS Or^ <1>. 



EVENT MEMORV CVCLE 

THE USER MAV SELECT ONE OF THE FOLLOWING COMHfiNDS : 
INSTR - INSTRUCTION ACQUISITION CVCLE 

MREAD ' - MEMORV READ CVCLE 
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MWRITE - MEMORV WRITE CVCLE 

IF NONE OF THE FiEOVE hFE SFECIFIED THE EVcf-Jf li: 
DEFINED TO BE HN't' MEr-iORV CYCLE. 



EVENT DFlTfl VflLUE 

Fl DftTfl BUS VriLUE MFiV BE SPECIFIED BV USE OF THE VRLUE COMMRND. 

VFlLUE <DflTH C MhSK] ;■ 

DFlTfl - VflLUE TO MATCH ON THE C'HTh BUS FOR AN EVENT 

MASK - INDICATES WHICH BITS OF DATA ARE TO BE COt-iFARED 

AGAINST THE DATA BUS. THE DEFAULT IS TO >rFFF C COMPARE 

ALL 16 BITS OF DATA > 



EVENT ADDRESS 

AN ADDRESS SPECIFICATION REQUIRES THE EVENT TO OCCUR 
AT THAT ADDRESS- 

AT ■; ADDRESS) 

ADDRESS - A HEMORV CVCLE AT THIS ADDRESS DEFINES flij E\ 



BREAKPOINT DELAV 

HALTING EMULATION OF THE TARGET SVSTEM NAV BE DELAVED 
FOLLOWING THE LAST EVENT BV USE OF THE DELAV COMMAND. 

DELAV < COUNT) 

COUNT - NUMBER OF TRACE SAMPLES TO TAKE FOLLOWING THE 
LAST EVENT (BREAKPOINT CONDITIOrJv BEFORE HALTir.G 
EMULATIOrj, COUNT MAV BE liJ THE RANGE O TO a^'C. 



:*i :+: + ;^< 4; ;+- ;+: :+: :+: :+. :+::+::+;;+::+: + ;t. :+::+: :f + :+,.+;:+.;++:+: + + :+: + *+ f- - K + ■+:4. .i^ ■+-+ T -r *■+■+-+■ -t + + + T t .^ +: + ■*■ -f- -1 

TRACE.-BREAKPOINT SPECIFICATION EXAMPLES . 

THE COMMANDS DESCRIBED ABOVE SHOULD BE INV0K:ED IN THE ORDER 
GIVEN, THEIR USE IS ILLUSTRflTEC' BELOW NOTE THAT THE OFTiONAi- 
ARGUMENTS OF EACH COMMAND DEFAULT TO REASONABLE vALUES. 

TRACE . . TRACE INFINITE NUMBER OF ALL MEMORV CVCLEi 

TRACE <iO.. IRQ) . , TRACE NE):T IS jTiSTRUCTION ACOUISTTIONS 

TRACE lO, IAQ:' . TRACE INFINITE NUtiBER OF INSTrUCTIu.N ACQUISITIONS 

TILL . . BREAKF0I"4T ON THE FIRST EVE'-' 

TILL<iO) . . BREAKPOINT ON THE TENTH E'':£'!i~ 
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INSTR 
MREftD 
MWRITE 



FIN EVENT MUST BE AN INSTRUCTION ACQUISITION 
AN EVENT MUST BE fl MEMORV READ 
AN EVENT MUST BE A MEMORV WRITE 



VALUE <>10FF> . . LOOK FOR M0FF ON THE DATA BUS 

VALUE C>100e.>FF00:> ..LOOK FOR >10XX ON THE DATA BUS <X^DON-T CARE> . 

ATO100) . . LOOK FOR >100 ON THE ADDRESS BUS 

DELAV<10) . . TAKE TEN MORE TRACE SAMPLES BEFORE HALTING 
. . EMULATION FOLLOWING N EVENTS. 



THE COMMANDS ARE USED IN CONJUNCTION TO DEFINE 
THE DEBUG CONFIGURATION. 



TRACE 

TILL 

INSTR 



. . TRACE ALL MEMORV CYCLES 

. . TILL THE FIRST 

. . INSTRUCTION ACQUISITION 



TRACE <0> IAQ> 
TILL <10) 
MREAD 
AT <WP) 
DELAY <128> 



TRACE ALL INSTRUCTION ACQUISITIONS 

TILL THE 10TH 

MEMORV READ 

AT WP < REGISTER ZERO 

THEN CONTINUE TRACING FOR 128 MORE INSTRUCTIONS 



THE COMMANDS MAV BE TYPED ON THE SAME LINE. 

TRACE TILL<2> MWRITE VALUE < 0200) AT < 01224) DELAY (10) 

MEANS: TRACE ALL MEMORV CYCLES 
TILL THE SECOND 

MEMORY WRITE CYCLE OF VALUE HEX 200 AT ADDRESS HEX 1234 
DELAY 10 MEMORY CYCLES THEN HALT EMULATION. 
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. . TITLE: EDUMP: DUMP ftDDRESSES FROM EMULATOR TRfiCE BUFFER 

..REVISION: 03/28/77 

..REVISION: 09/09/77 9980 UPDATES 

ABSTRACT ' 

EDUMP PRINTS THE CONTENTS OF A SPECIFIED RANGE OF THE EMULATOR'S 
. . TRACE BUFFER, INTERPRETED AS EVEN ADDRESSES TAKEN FROM THE EMULATOR'S 
. . MEMORV ADDRESS BUS. 

. . USAGE : 

THE EMULATOR MUST BE SET UP TO TRACE ADDRESSES IN ITS BUFFER> 
. . BEFORE IT IS RUN. AFTER IT HAS HALTED, FOR WHATEVER REASON, EDUMP 
. . MAV BE USED TO EXAMINE A SEQUENCE OF TRACED ADDRESSES. EDUMP PRINTS 
. . ONE ADDRESS PER LINE. AT THE LEFT MARGIN IT PRINTS THE INDEX INTO 

. THE EMULATOR TRACE BUFFER. NEXT IT PRINTS THE SAMPLED ADDRESS IN 
. . HEXADECIMAL. LAST IT PRINTS THE CONTENTS OF THE ADDRESSED WORD OF 
..TARGET MEMORV, IN HEXADECIMAL, AS TWO ASCII CHARACTERS, AND DISAS- 
. . SEMBLED AS AN INSTRUCTION WORD. NOTICE THAT THE DISASSEMBLV MAV 
. . REQUIRE THE VALUES OF REGISTERS, AND THAT THESE VALUES WILL NOT 
. . BE LIKELV TO BE THE SAME AT THE TIME OF DISASSEMBLV AS AT THE TIME 
. . OF EXECUTION OF THE INSTRUCTION. IF THE 9980 EMULATOR IS BEING 
. . USED, THEN THE ADDRESSES TRACED MAV BE BOTH EVEN AND ODD FOR 
. . EACH BVTE FETCHED OR, IF THE TRACE MODULE QUALIFIER Q0 IS BEING 
. . USED TO QUALIFV SAMPLES, THEN JUST ODD, OR JUST 

. EVEN ADDRESSES MAV BE TRACED. PLEASE REFER TO THE APPROPRIATE 
. . SECTION OF THE MANUAL FOR A DISCUSSION OF TRACING WHEN USING THE 
. . 9980 EMULATOR. 

EDUMP HAS ONE REQUIRED AND ONE OPTIONAL ARGUMENT. FIRST IS THE 

. STARTING INDEX TO BE USED. THE OPTIONAL SECOND ARGUMENT SPECIFIES 
, . THE ENDING INDEX TO BE USED. IF IT IS OMITTED, THE STARTING INDEX 
. . PLUS NINETEEN IS USED, GIVING TWENTV SAMPLES. 

'DEFINING EDUMP' NL 

PROC EDUMP <0, 2> BEGIN 
IF ARG EQ 

THEN LOC 2 = ETBO 
ELSE LOC 2 = ARG li 
IF ARG GE 2 

THEN LOC 1 = ARG 2 
ELSE LOC 1 = LOC 2 + 19j 
IF LOC 1 GT ETBN 

THEN LOC 1 = ETBNi 
'EMU INDEX ADDR CONTENTS< HEX, ASCII, INSTR> '; NL; 
WHILE LOC 2 LE LOC 1 
DO BEGIN 

LOC 2:H0i 

ETB<LOC 2>:X4H '/ '; 
eETB-CLOC 2> :HAI; 
LOC 2 = LOC 2+1 
END; 
END 
TITLE: TDUMP: DUMP DATA BUS SAMPLES FROM THE TRACE BUFFER 
REVISION: 03/28/77 

09/09/77 9980 UPDATES 

RBSTRfiCT 

TDUMP PRINTS THE CONTENTS OF THE TRACE MODULE TRACE BUFFER 
ON THE CONSOLE, ASSUMING THAT THE TRACE MODULE HAS BEEN SET TO 
TRACE THE EMULATOR DATA BUS. IN THIS MODE THE LOW-ORDER Id BITS 
OF EACH SAMPLE ARE TAKEN FROM THE DATA BUS AND THREE OF THE HIGH- 
ORDER 4 BITS ARE TAKEN FROM THE BUS CONTROL LINES AND THE EMULATOR 
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COMPARISON CIRCUITRV. IF THE TRfiCE SftMPLES ARE NOT flCTUflLLV FROM 
THE EMULATOR'S DATA BUS. THE INTERPRETATION PROVIDED BV THIS 
PROCEDURE WILL BE MEANINGLESS. THE FOLLOWING TRACE MODULE 
SETUP SHOULD BE USED TO PROPERLV SET UP THE 9900 EMULATOR 
TO TRACE 16 BIT DATA VALUES (OR THE 9980 EMULATOR TO TRACE 8 
BIT DATA VALUES >. 

TTRC<DATA, 256. EXT) 

THE TRACING QUALIFIER "Q0" IS NECESSARV FOR TRACING 16 BIT DATA 
VALUES IN THE 9980 EMULATOR. THE FOLLOWING TRACING SETUP IS USED. 

TTRC<DATA-Q0, 256> EXT> 

PLEASE REFER TO THE APPROPRIATE SECTION OF THE MANUAL FOR A 
DISCUSSION OF TRACING WHILE USING THE 9980 EMULATOR. THE ABOVE 
COMMANDS SET THE TRACE MODULE TO STORE UP TO 256 SAMPLES BEFORE "FULL" 
BECOMES TRUE. THE NUMBER MAY' BE ANYTHING BETWEEN 1 AND 256, AND THE 
TERMINATION MODE MAV BE ANYTHING. THE IMPORTANT POINTS ARE THAT 
"DATA" MODE IS SELECTED AND "EXT" CLOCK IS USED (EMULATOR'S MEMORY 
CYCLE CLOCK). OF COURSE, THE DATA CABLE MUST BE CONNECTED FOR THE 
DATA BUS TO BE AVAILABLE FOR THE TRACE MODULE. 

USAGE : 

AFTER THE TRACE MODULE HAS HALTED <BV ITSELF, UNDER CONTROL OF 
THE EMULATOR, OR BY THE USER WITH "THLT"> THE TRACE BUFFER MAY BE 
DUMPED WITH TDUMP. THERE IS ONE REQUIRED ARGUMENT AND ONE OPTIONAL 
ARGUMENT. THE FIRST IS THE STARTING INDEX TO BE USED. THE SECOND 
IS THE ENDING INDEX TO BE USED, IF IT IS OMITTED, THE START- 
ING INDEX PLUS 19 IS USED, TO DUMP 20 SAMPLES. 

EACH SAMPLE IS PRINTED ON A SEPARATE LINE. IN THE LEFT MARGIN, 
THE INDEX IS PRINTED. NEXT, IF THE EMULATOR COMPARE CIRCUIT WAS 
TRUE WHEN THE SAMPLE WAS TAKEN, *ECMP IS PRINTED. NEXT THE LOW- 
ORDER 16 BITS OF THE SAMPLE ARE PRINTED IN ONE OF THREE FORMATS. 
IF THE INSTRUCTION ACQUISITION LINE WAS TRUE WHEN THE SAMPLE WAS 
TAKEN, THEN THE SAMPLE IS DISASSEMBLED AS AN INSTRUCTION. IF 
NOT, THEN IF THE DATA BUS IN LINE WAS TRUE THE WORD "READ" IS 
PRINTED, OTHERWISE THE WORD "WRITE", AND FINALLY THE SAMPLE IS 
PRINTED IN HEXADECIMAL AND AS TWO ASCII CHARACTERS. IF THE 
TRACE MODULE WAS SET TO TRACE 8 BIT VALUES ON THE 9980 EMULATOR 
DATA BUS, THEN THE INSTRUCTION INTERPRETATION OF A SAMPLE 
ABOVE WILL BE MEANINGLESS. 

DEFINING TDUMP' NL 



PROC 


TDUMP (0, 2> BEGIN 




IF 


ARG EQ 








THEN LOC 2 = 


TTBO 






ELSE LOC 2 = 


ARG 1 




IF 


ARG GE 2 








THEN LOC 1 = 


ARG 2 






ELSE LOC 1 = 


LOC 2 


+19, 


IF 


LOC 1 GT TTBN 








THEN LOC 1 = 


TTBN; 




'TRA INDEX ECMP 


? DATA<: HEX, ASCII) 


WHILE LOC 2 LE LOC 1 DO 


'BEGIN 




LOC 2.ND, 








IF TTBH<LOC 


2, EMU) 






THEN ' 


*ECMP 




ELSE •■ 




'; 



INTERPRETATION ■.; NL, 
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LOC 
END 
END 

TITLE: 
REVISION 



TTB<LOC 2>;Hft; 

IF TTBH<LOC 2. IftQ> 

THEN TTB<LOC 2).X7I 
ELSE BEGIN 

IF TTBH<LOC Z. DBIN> 
THEN ' 
ELSE ' 
TTB<LOC 2):H 
END; 
2 = LOC 2+1 



REfiD 
WRITE 



TEDUMP : 

02/28/7; 

09/09/7; 



DUMP EMULATOR FIND TRACE BUFFERS TOGETHER 



9980 UPDATES 



ABSTRACT : 

TEDUMP PRINTS THE CONTENTS OF THE EMULATOR AND TRACE MODULE 
TRACE BUFFERS TOGETHER. TEDUMP ASSUMES THAT THE EMULATOR HAS SAMPLED 
ADDRESSES AND THE TRACE MODULE DATA, AND THAT THE QUALIFIERS FOR THE 
TWO TRACINGS WERE THE SAME. THIS IMPLIES THAT ON EVERV QUALIFIED 
MEMORV CVCLE BOTH THE EMULATOR AND THE TRACE MODULE SAMPLED SIMUL- 
TANEOUSLV. THUS THE SAMPLES IN THE TWO BUFFERS ARE SYNCHRONIZED, 
AND MAV BE CONSIDERED TOGETHER MEANINGFULLV. THERE ARE VARIOUS 
WAVS TO ACHIEVE THIS, ONE OF WHICH IS TO TRACE ALL MEMORV CVCLES 
IN BOTH BUFFERS. 

USAGE : 

TEDUMP MAV ONLV BE CALLED WHEN THE TRACE MODULE AND THE EMULATOR 
ARE BOTH HALTED. 

BEFORE TRACING, THE USER SHOULD ENSURE THAT THE DATA CABLE AND 
THE CONTROL CABLE ARE BOTH CONNECTED. HE SHOULD SET UP TRACING IN 
EACH MODULE SO THAT BOTH SAMPLE SIMULTANEOUSLY. THE EASIEST WAV TO 
ACCOMPLISH THIS IS TO USE THE EXTERNAL CLOCK SELECTION IN BOTH ETRC 
AND TTRC. FURTHER, THE EMULATOR SHOULD TRACE ADDR AND THE TRACE 
MODULE SHOULD TRACE DATA+X, WHERE X IS ANV DESIRED QUALIFICATION. 
THE TRACE MODULE SHOULD NOT HALT ITSELF, BUT MAV HALT THE EMULATOR 
AND THEN HALT AS A RESULT OF THE EMULATOR HALTING. WHEN USING 
THE 9980 EMULATOR, THE QUALIFIER Q0 SHOULD BE USED FORCE FULL 
16 BIT < RATHER THAT 8 BIT > DATA TRACES TO OCCUR IN THE TRACE MODULE. 

THE FOLLOWING SETUP WILL TRACE THE EXECUTION OF 10 INST- 
RUCTIONS IN THE EMULATOR. THE EMULATOR AND TRACE COMMANDS NOT 
MENTIONED CECMP, EEVT, TCMP, TEVT) MAV BE SET HOWEVER THE USER WISHES. 
THE SETUP IS CORRECT FOR TRACING 16 BIT DATA VALUES WHEN USING 
THE 9900 EMULATOR OR 8 BIT DATA VALUES IN THE 9980 EMULATOR. THE 
QUALIFIER "-Q0" SHOULD BE USED ON THE "DATA" PARAMETER OF THE 
TTRC COMMAND IF THE USER WISHES TO TRACE 16 BIT DATA VALUES 
FETCHED BV THE 9980. PLEASE REFER TO THE APPROPRIATE SECTION OF 
THE MANUAL FOR A DISCUSSION OF TRACING WITH THE 9980 EMULATOR. 

ETRC < ADDR, 10, EXT> 
TTRC •; DATA, 256, EXT> 
EBRK<FULL, SELF> 
TBRK<OFF, OFF> 

THE TRACE MODULE MAV BREAK ON EITHER FULL OR EVT, BUT MUST CONTINUE 
TRACING UNTIL THE EMULATOR HAS STOPPED TRACING. 

AFTER THE EMULATOR HAS HALTED, HALTING THE TRACE MODULE WITH 
IT VIA THE CONTROL CABI!!e, THE TWO BUFFERS CONTAIN THE SAME NUMBER 
OF SAMPLES, TAKEN AT THE SAME TIMES. TEDUMP MAV BE USED TO DUMP 
THEM IN PARALLEL, SHOWING BOTH THE ADDRESS AND DATA LINES OF THE 
EMULATOR'S MEMORV BUS. 
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TEDUMP HAS TWO. ftRQUMENTS; STfiRT AND END. THE Rf=lNGE OF INDICES 
STfiRT. . . END IS USED TO DISPLftV SAMPLES FROM THE EMULATOR BUFFER. 
IF END IS OMITTED, START PLUS 19 SAMPLES ARE DISPLAYED GIVING 
A 20 SAMPLE DEFAULT DISPLAV. 

CORRESPONDING SAMPLES ARE TAKEN FROM THE TRACE MODULE BUFFER BUT 
WITH POSSIBLV DIFFERENT INDICES, IF TCMP AND TEVT HAVE BEEN SET TO 
COUNT EVENTS AND DELAVS. THESE ARE DISPLAYED IN THE APPROPRIATE 
FORMAT ACCORDING TO THE CONTROL SIGNALS TRACED IN THE HIGH FOUR 
BITS OF EACH TRACE BUFFER WORD. REMEMBER THAT IF A 9986 
EMULATOR IS BEING USED, THE QUALIFIER QO DETERMINES WHETHER 
<A) BVTE ADDRESSES AND DATA ARE BEING TRACED OR <B> ODD WORD 
ADDRESSES AND 16 BIT DATA VALUES ARE BEING TRACED. REFER 
TO THE APPROPRIATE SECTION OF THE MANUAL FOR DISCUSSION 
OF TRACING WITH THE 9980 EMULATOR. 

'DEFINING TEDUMP' NL 



PROC TEDUMP <0, 4 > BEGIN 
'EMU INDEX ECMP? ADDR TRA INDEX DATA < HEX, ASO INTERPRETATION' 
NLi 
IF ARG EQ 

THEN LOC 1 = ETBO; 
ELSE IF ARG 1 LT ETBO 
THEN LOC 1 = ETBO 
ELSE LOC 1 '^ ARG 1^ 
IF ARG GE 2 

THEN LOC 2 = ARG 2 
ELSE LOC 3 = LOC 1 + 19; 
LOC 4 = TTBN - <TTBO-ETBO> 
IF ETBN GT LOC 4 

THEN LOC 4 = ETBN; 
IF LOC 3 GT LOC 4 

THEN LOC 3 = LOC 4; 



END WAS SUPPLIED 
END WAS NOT SU PLIED 



LOC 2 = TTBO + LOC 1 - ETBO; 
WHILE LOC 1 LE LOC 3 
DO BEGIN 
IF LOC 



INITIAL TRACE BUFFER INDEX 



2 GE TTBO AND LOC 2 LE TTBN 
THEN LOC 4 = -1 ELSE LOC 4=0; 
IF LOC 1 GE ETBO AND LOC 1 LE ETBN 
THEN BEGIN 

LOC 1;ND; ... PRINT INDEX IN ETB 

IF LOC 4 EQ THEN ' — N/A — ' 
ELSE IF TTBH<LOC 2, EMU> 



THEN ' *ECMP 
ELSE ' 
ETB<LOC 1):H; 
END; 
IF LOC 4 NE THEN 
BEGIN 
LOC 2 ; D4; 
TTB<LOC 2J.X4HA; 
IF TTBH<LOC 2, lAQ) 

THEN TTB<LOC 2>;X4I 
ELSE BEGIN 

IF TTBH<LOC 
THEN ' 
ELSE ' 
TTB«LOC 2> :H; 
END; 
END; 

LOC 2 = LOC 2+1; 
LOC 1 = LOC 1+1; 



EMULATOR COMPARE TRUE 



ADDRESS 



.PRINT THE INDEX IN TTB 

... PRINT VALUE IN HEX 

. . . DISPLAV THE INSTRUCTION 
... ITS A DATA ACCESS 
2, DBIN> 

READ . . . IT S fl READ 
WRITE -; ... ITS A WRITE 
. . . DISPLAV THE DATA 



STEP TTB 
STEP ETB 



INDEX 
INDEX 
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END 
END 
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TITLE: 
REVISION; 



FNOBVT; SEfiRCH MEMORV FOR 
06/07/77 



ft SPECIFIED SUBBVTE 



HBSTRfiCT : 

FNOBVT SERRCHES fi SPECIFIED RRNGE OF MEMORV IN THE TfWGET 
SVSTEM TO FIND fl BVTE CONTAINING fl SPECIFIED VALUE. IN fl SPECIFIED 
FIELD. 

USAQE : 

FNOBVT CAN BE CALLED WHENEVER THE EMULATOR IS HALTED. 
FNOBVT CAN HAVE ONE TO FOUR ARGUMENTS. THE POSSIBLE FORMS ARE 
GIVEN BELOW: 

FNDBVT< START, END- VALUE, MASK) 

FNDBVT< START, END, VALUE) 

FNOBVT < VALUE, MASK> 

FNOBVT < VALUE) 
THE ARGUMENTS, THEIR MEANINGS, AND THEIR DEFAULT VALUES ARE 
DESCRIBED BELOW. 

NAME MEANING DEFAULT 



START 
END 
VALUE 
MASK 



LOW END OF ADDRESS RANGE TO SEARCH 
HIGH END OF ADDRESS RANGE 
INTERESTING FIELD TO SEARCH FOR 
ONE BITS IN INTERESTING POSTITIONS 




>FFFF 

>00FF 



THE RANGE OF BVTES ADDRESSES START. . . END IS SEARCHED FOR THE 
FIRST OCCURRENCE OF VALUE IN A BVTE. EACH BVTE IS MASKED WITH MASK 
AND THEN COMPARED TO VALUE, SO THE INTERESTING FIELD MUST BE IN THE 
CORRECT POSITION IN VALUE. IF SUCH AN OCCURRENCE IS FOUND, FNOBVT 
RETURNS THE ADDRESS OF THE BVTE. IF NONE IS FOUND, FNOBVT RETURNS 
>FFFF. THIS UNFORTUNATE AMBIGUITV CANNOT BE RESOLVED SIMPLV, SO 
IT IS LEFT TO THE USER OF FNOBVT TO DETERMINE WHETHER >FFFF IS IN 
FACT A VALID ANSWER OR JUST A FAILURE FLAG. 

'DEFINING FNOBVT' 



FUNC FNOBVT <1, 8) BEGIN 
IF ARG GE 2 

THEN BEGIN 

LOC 1 = ARG 1; 
LOC 2 = ARG 2; 
LOC 2 = ARG 2; 
END ELSE BEGIN 
LOC 1 = 0; 
LOC 2 = >FFFF; 
LOC 3 = ARG 1; 
END; 
IF ARG MOO 2 

THEN LOC 4 = >FF 
ELSE LOC 4 = ARG ARG 0; 
LOC 5 = MPV<LOC 2, 256); 
LOC 6 = MPV<LOC 4,256); 
LOC 7 = LOC 1; 
REPEAT BEGIN 

LOC 3 = eLOC 1; 

IF CLOC 8 AND LOC 6) EQ LOC 5 

THEN RETURN LOC 1; 
IF <LOC 8 fiHD LOC <)) EQ LOC 3 

THEN RETURN LOC 1+1; 
LOC 1 = LOC 1+2; 
END UNTIL LOC 1 HI LOC 2 OR LOC 1 LOE LOC 
RETURN -1 



RANGE WAS SPECIFIED 

START 

END 

VALUE 

RANGE WAS NOT SPECIFIED 



MASK WAS NOT SPECIFIED 
MASK WAS SPECIFIED 
HIGH BVTE VERSION OF VALUE 
HIGH BVTE VERSION OF MASK 
SAVE COPV OF START 

FETCH A WORD " 

FOUND IT IN HIGH BVTE 

FOUND IT IN LOW BVTE 
STEP TO NEXT WORD 



END 
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TITLE. 
REVISION; 



FNDWRD : 
02/21/7: 



SEARCH TftRGET MEMORV FOR fl SUBWORCJ 



flBSTRfiCT ' 

FNDWRD SEARCHES fl SPECIFIED RfiNQE OF TARGET MEMORV FOR A WORD 
CONTAINING A SPECIFIED VALUE IN A SPECIFIED FIELD. IT RETURNS THE 
ADDRESS OF THE FIRST SUCH WORD FOUND IN THAT RANGE. 

FNDWRD MAV BE CALLED WHENEVER THE EMULATOR IS HALTED. IT MAV 
HAVE AS MANV AS FOUR ARGUMENTS, OR AS FEW AS ONE. EACH FORMAT 
IS LISTED BELOW. THE RANGE IS INCLUSIVE. 

FNDWRD < START, END, VALUE, MASK> 

FNDWRD < START, END, VALUE? 

FNDWRD < VALUE, MASK > 

FNDWRD < VALUE > 
IN EACH FORM, THE ARGUMENTS AND THEIR DEFAULT VALUES ARE AS FOLLOWS. 

NAME MEANING DEFAULT 



START 

END 

VALUE 

MASK 



LOW END OF ADDRESS RANGE 
HIGH END OF ADDRESS RANGE 
THE INTERESTING VALUE, IN ITS 
PROPER FIELD 

THE INTERESTING FIELD HAS ONE 
BITS IN IT 





0FFFE 



0FFFF 



'DEFINING FNDWRD' 

FUNC FNDWRD <1, 5> BEGIN 
IF ARG GE 3 

THEN BEGIN 

LOC 3 = ARG 3; 
LOC 1 = ARG 1; 
LOC 2 = ARG 2; 



END ELSE BEGIN 



LOC 3 
LOC 1 
LOC 2 
END; 
IF ARG MOD 2 
THEN LOC 4 
ELSE LOC 4 
LOC 5 = LOC 1; 
REPEAT BEGIN 

IF <(?LOC 1 



ARG li 
0FFFE; 



-1 

ARG ARG 0; 



WAS RANGE GIVEN? 
RANGE WAS GIVEN. 
VALUE ARGUMENT IS THIRD 
LOW END OF RANGE 
HIGH END OF RANGE 
RANGE WAS NOT GIVEN 
VALUE ARGUMENT IS FIRST 
USE RANGE 0. . . 
0FFFE 

, WAS MASK GIVEN? 

, NO, USE WHOLE WORD 

. VES.. USE SPECIFIED MASK 

. SAVE LOW END FOR CHECKING 



AND LOC 4> EQ <LOC 3 AND LOC 4) 
THEN RETURN LOC 1; 
LOC 1 = LOC 1+2; 
END UNTIL LOC 1 HI LOC 2 OR LOC 1 LOE LOC 5, 
END 
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TITLE; 
REVISION: 



HIST: 
04/06/77 



GENERAL PURPOSE HISTOGRAM ROUTINE 



ABSTRACT : 

ONE PROCEDURE DEFINITION IS CONTAINED IN THIS FILE. 
IN ADDITION AN ARRAV CHISTAR) IS DEFINED AND THE USER 
MUST PROVIDE A FUNCTION < SAMPLED AND ONE USER VARIABLE <S>. 
THE HIST ROUTINE COLLECTS SAMPLES TO EVENTUALLV PLOT A 
HISTOGRAM OF FREQUENCV OF SAMPLES OVER A SPECIFIED RANGE. 

USAGE : 

HIST IS CALLED WITH TWO ARGUMENTS WHICH DEFINE THE 
RANGE OF SAMPLES OVERWHICH TO BUILD THE HISTOGRAM. FOR 
EXAMPLE 'HISTO1000, >2000)' WILL CONSTRUCT A HISTOGRAM 
OF SAMPLES BETWEEN THE RANGE OF >1000 TO >2000 < SAMPLES 
OUTSIDE OF THIS RANGE ARE IGNORED). IF NO ARGUMENTS ARE 
SPECIFIED THE RANGE DEFAULTS TO >0ee0 TO >FFFF. SAMPLES' 
ARE OBTAINED THROUGH A FUNCTION WHICH MUST ALREADV BE 
DEFINED AT THE TIME HIST IS COPIED IN. IN ADDITION THE USER 
SVMBOL 'S' MUST BE DEFINED. AS LONG AS 'S' IS NON ZERO 
SAMPLES WILL BE TAKEN BV THE 'HIST' ROUTINE. FOR EXAMPLE: 
PROC SAMPLE BEGIN 

. . , STUFF TO OBTAIN THE SAMPLE VALUE 
IF <CONDITION> THEN S=0 . . . SIGNAL TO STOP TAKING SAMPLES 
RETURN <SAMPLE VALUE> 
END 

'DEFINING HI STAR - HISTOGRAM ARRAV 

DELE <'HISTAR'> ..DELETE ANV EXISTING HI STAR ARRAV 

ARRAV HISTAR<64> , . DEFINE HISTOGRAM ARRAV 

'DEFINING HIST<RANGE> - HISTOGRAM ROUTINE' 
PROC HIST <0, ?■) BEGIN 

. . . HISTOGRAM OF SAMPLES OVER fl GIVEN RANGE 

NOTE : : TWO ADDITIONAL ITEMS ARE NECESSARV TO USE 

THIS PROCEDURE: DA VARIABLE 'S' - AS LONG AS 

THIS VARIABLE IS NON ZERO SAMPLES ARE TAKEN. 

2> A FUNCTION 'SAMPLE' WHICH RETURNS A SAMPLE VALUE. 

ARGUMENT 1 IS THE LOWER LIMIT OF THE VALUE. <0> 

ARGUMENT 2 IS THE UPPER LIMIT OF THE VALUE. <>FFFF> 

LOC 1 IS THE LOW END OF THE RANGE. 

LOC 2 IS THE HIGH END OF THE RANGE. 

LOC 3 IS THE BUCKET WIDTH 

DETERMINE THE DEFAULT VALUES IF NECESSARV 

IF ARQ GE 1 THEN LOC 1 = ARG 1 ELSE LOC 1 =• 0; 

IF ARG GE 2 THEN LOC 2 =^ ARG 2 ELSE LOC 2 ^ 0FFFF; 

. . . ZERO THE HISTOGRAM ARRAV (LOC 10. . . LOC 75 > 

FOR LOC 4 = 1 TO 64 DO HISTARCLOC 4> = 

. . . DETERMINE THE BUCKED WIDTH 



MDR = 

LOC 3 = DIVC64, LOC 2 - LOQ 1 + 63) 



. BUCKET WIDTH 



'THE BUCKET WIDTH IS 



LOC 3:HN; 
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. . . COLLECT SAMPLES 

WHILE S DO BEGIN 

LOC 5 = SfiMPLEi . . GflTHER fi S8MPLE 

IF <LOC 3 HIE LOC 1) AND <LOC 5 LO LOC 2> THEN BEGIN 
LOC 6 = LOC 5 - LOC 1 
MOR = 

LOC 3 = 1+DIV<L0C 3, LOC 6) . . COMPUTE BUCKET INDEX 

HISTflR<LOC 5>=HISTfiR<L0C 5) + 1; . . INCREMENT COUNT 
END; 
END; 

... PRINT OUT THE VALUES IN THE HISTOGRFMI RRRflV 

FOR LOC 4 = i TO 64 DO BEGIN 

IF LOC 4 MOD 8 EQ THEN NL; 
HISTflR<LOC 4> :D; 
END; NL; 

... FIND THE MAXIMUM VALUE IN HISTOGRAM ARRAY 

LOC 4 = HISTAR<1> . . ASSUMED MAXIMUM 

FOR LOC 5 = 1 TO 64 DO ... ARRAV INDEX 

IF HISTAR<LOC 5> QT LOC 4 THEN LOC 4 = HISTARCLOC 5>; 

'THE MAXIMUM IS '; LOC 4:D; NL; 

IF LOC 4 EQ THEN BEGIN 'QUITTING'; RETURN; END; 

... FIND THE SCALING FACTOR 

LOC 4 = LOC 4 +7 

MDR=0 

LOC 4 = DIV<8, LOC 4>; 

'THE SCALE IS '; LOC 4:D;. . . . ' TVPE A NUMBER TO CONTINUE'; 

LOC 5=8; . . INITIALIZE LINE COUNT 

WHILE LOC 5 GE 1 DO BEGIN . . . LOOP TO SCAN fl PAGE 

NL; 

LOC 6=L0C 5*L0C 4 

FOR LOC 7 = 1 TO 64 DO . . SCAN A LINE 
IF HISTARCLOC 7> GE LOC 6 THEN '*'; ELSE ' '; 

LOC 5=L0C 5-1; 

END; 

' . . PRINT HISTOGRAM 'HEADER' 
NL; 

.- H 1 1 1 + ' .; 

NL; 

MDR=0 

LOC 4=DIV<;4, LOC 2 - LOC 1 + 1>; 

LOC 1:HX7;L0C 1+LOC 4 . HX9; . . . LABEL AXIS 

LOC 1+<2*L0C 4>:HX9;L0C 2-LOC 4 : HX9; 

LOC 2:HN, 

HISTOGRAM OF SAMPLES OVER A RAf^GE'; . . PRINT TITLE 
END 
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TITLE: 
REVISION: 



BL: SIMULATE fl BRANCH AND LINK INSTRUCTION 
05/02/77' 



. THE OLD PC 
. NEW PC 



ABSTRACT ■ 

BL SIMULATES THE EXECUTION OF A BL INSTRUCTION IN THE 
TARGET SVSTEM. BL MAY BE CALLED WHENEVER THE EMULATOR IS HALTED. 

USAGE : 

BL HAS ONE ARGUMENT, THE ADDRESS TO TRANSFER IN THE TARGET 
SVSTEM. THE CURRENT PC IS STORED INTO REGISTER ELEVEN <R11) 
AND THE PC CHANGED TO THE ADDRESS TO TRANSFER TO. THE CURRENT 
WORKSPACE POINTER IS NOT CHANGED. NOTE THAT THE PC IS NOT 
INCREMENTED BEFORE IT IS STORED. 

'DEFINING BL' NL 

PROC BL<1) BEGIN 
Rll = PC; 
PC = ARG 1 
END 

TITLE: BLWP: SIMULATE A BLWP INSTRUCTION 
REVISION: 03/21/77 

ABSTRACT : 

BLWP SIMULATES THE EXECUTION OF A BLWP INSTRUCTION IN THE 
TARGET SVSTEM. BLWP MAV BE CALLED WHENEVER THE EMULATOR IS HALTED. 

USAGE : 

BLWP HAS ONE ARGUMENT- THE ADDRESS OF A TRANSFER VECTOR IN 
TARGET MEMORV. THE FIRST WORD OF THE TRANSFER VECTOR IS LOADED INTO 
THE WORKSPACE POINTER AND THE SECOND WORD INTO THE PROGRAM COUNTER. 
THE PREVIOUS WP> PC, AND ST ARE STORED IN R12, R14, AND R15, RESPEC- 
TIVELV, OF THE NEW WORKSPACE. NOTE THAT THE PC IS NOT ir«;REMENTED 
BEFORE IT IS STORED. 

-DEFINING BLWP' NL 



PROC BLWP<1, i:> BEGIN 

LOC 1 = WP; 

WP = eARG 1; 

R13 = LOC li 

R14 = PCi 

R15 = ST; 

PC = l?<ARG 1 
END 

TITLE: 
REVISION: 



+ 2>; 



THE CURRENT WP 
THE NEW WP 
THE OLD WP 
THE OLD PC 
THE OLD ST 
THE NEW 'PC 



INTR: SIMULATE AN INTERRUPT IN TARGET SVSTEM 
03/21/77 



flBSTRflCT 

INTR SIMULATES THE OCCURRENCE OF AN INTERRUPT ON A PARTICULAR 
INTERRUPT PRIORITY LEVEL. INTR FUNCTIONS THE SAME WAY THAT THE 
INTERRUPT ARBITRATION HARDWARE DOES. THAT IS, THE INTERRUPT IS ONLY 
HONORED IF THE CPU'S PRIORITY IS HIGHER THAN THE LEVEL ON WHICH THE 
INTERRUPT IS RAISED. IF THE PRIORITY ALLOWS THE INTERRUPT •-'DETER- 
MINED BY CHECKING ST> TO OCCUR, THEN A BLWP TRANSFER IS PERFORMED 
THROUGH THE VECTOR STORED AT THE APPROPRIATE INTERRUPT LEVEL. 
ALSO, THE PRIORITY OF THE CPU IS SET TO THE LEVEL OF THE INTERRUPT 

, MINUS ONE. 

INTR HAS ONE ARGUMENT, THE LEVEL OF THE INTERRUPT REQUEST. 
INTR MAY BE CALLED WHENEVER THE EMULATOR IS HALTED. INTR RETURNS 
. IF THE INTERRUPT WAS NOT ALLOWED, AND -1 IF IT WAS. 



Figure H-9. Listing of INSTR Procedure FUe (Sheet 1 of 3) 



H-35 



Digital Systems Division 




946244-9701 



'DEFINING FUNCTION INTR' NL 



FUNC INTR<1, 12> BEGIN 

IF <ST fiND 15> GE HRG 1 
THEN BEGIN 

LOC 1 = WP; 

WP = 0<flRG i * 4>; 

R12 = LOC li 

R14 = PC; 

R15 = STi 

PC = (»<flRG 1*4 + 2>; 

LOC 1 = RRQ X - li 

IF LOC 1 LT 

THEN LOC 1 = 0i 
ST = <ST AND 0FFF0> + LOC 1; 
RETURN -±i 
END ELSE 

RETURN 0; 

END 

...TITLE: RT; SIMULATE AH RT INSTRUCTION IN TARGET SVSTEM 

. . . REVISION: 05/02/77 



INTERRUPT IS ALLOWED 

SAVE OLD WORKSPACE POINTER 

NEW MP 

OLD WP 

OLD PC 

OLD ST 

NEW PC 

NEW PRIORITY 

. PATCH FOR LEVEL ZERO 

. NEW ST 

. INTERRUPT SUCCEEDED 

. INTERRUPT FAILED 



flBSTRfiCT ' 

RT SIMULATES THE EXECUTION OF AN RT INSTRUCTION IN THE TARGET 
SVSTEM. THE CURRENT PROGRAM COUNTER CPC) IS CHANGED TO THE CONTENTS 
. OF REGISTER ELEVEN <THE RETURN ADDRESS >. 



USAGE: 

RT HAS NO ARGUMENTS. 
IS HALTED. 



RT MAV BE CALLED WHENEVER THE EMULATOR 



'DEFINING RT' NL 

PROC RT<0> BEGIN 

PC = Rlli 
END 

TITLE: RTWP: SIMULATE A RTWP INSTRUCTION IN TARGET iVSTEM 

..REVISION: 03/21/77 

flBSTRRCT ■ 

RTWP SIMULATES THE EXECUTION OF AN RTWP INSTRUCTION IN THE TARGET 
SVSTEM. 'WP> PC, AND ST ARE LOADED FROM R13, R14, AND RIG, RESPEC- 
. . TIVELV. 



RTWP MAV BE CALLED WHENEVER THE EMULATOR 



USAGE : 

RTWP HAS NO ARGUMENTS. 
. IS HALTED. 

'DEFINING RTWP' NL 

PROC RTWP<0> BEGIN 

ST = R15; 

PC = R14; 

WP = R13; 
END 

TITLE: XOP: SIMULATE AN XOP IN TARGET SVSTEM 
. . . REVISION: 05/02/77 

'. '. ABSTRACT: 

XOP SIMULATES AN EXTENDED OPERATION INSTRUCTION IN THE 
TARGET SVSTEM. TWO ARGUMENTS ARE EXPECTED: 

1> THE 'VALUE' TO PASS TO THE XOP HANDLER ROUTINE. 
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2> THE XOP LEVEL NUMBER. 
H BLWP OPERATION IS PERFORMED TO TRfiNSFER THROUGH THE 
flPPROPRIflTE XOP LEVEL. REGISTER ELEVEN CRllJ WILL CONTAIN 
THE 'VALUE' AS SPECIFIED BV THE USER. 



'DEFINING XOP' NL 



PROC X0P<2. 1> BEGIN 
LOG 1 = WP; 

WP = (J<ARG 2*4 + >40); 
R13 = LOC iJ 
R14 = PC; 
R15 = ST; 

PC = ©<ARQ 2*4+ >42>; 
Rll = ARC 1 

ST = ST OR oeeeeeieeeeeeeee 

END 



SAVE OLD WORKSPACE POINTER 

NEW WP 

OLD WP 

OLD PC 

OLD ST 

NEW PC 

VALUE TO PASS 



IN REGISTER 11 



'XOP' STATUS BIT 
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TITLE; SOFTWfiRE BRERKPOINTS 
REVISION: 07/1S/7T 

HBSTRfiCT ; 

THIS MODULE DEFINES USER PROCEDURES TO IMPLEMENT 
fl MULTIPLE BREBKPOINT SOFTWfiRE BREAKPOINT CflPflBILITV. 

USfiGE: 

THREE <3> PROCEDURES ARE flVfllLflBLE; 

SB - SET SOFTWfiRE BREflKPOINT 

CB - CLEflR SOFTWfiRE BREflKPOINT 

EB - EXECUTE FROM SOFTWfiRE BREAKPOINT 

'. EACH OF THESE ARE DESCRIBED INDIVIDUfiLLV BELOW. 

SOFTWfiRE BREAKPOINTS ARE IMPLEMENTED IN THE 
. TARGET SVSTEM AS SPIN INSTRUCTIONS. THE SPINS ARE PLflCED 

IN MEMORV USING THE 'SB' PROCEDURE. EXAMINATION OF TARGET 
. SVSTEM MEMORV AT SOFTWARE BREAKPOINT LOCfiTIONS 
WILL REVEAL SPIN INSTRUCTIONS < >10FF / JMP « >. 
THE 'CB' PROCEDURE IS USED TO CLEAR A SOFTWfiRE BREAKPOINT. 
. THE EXECUTE FROM SOFTWARE BREAKPOINT C'EB'J PROCEDURE STARTS THE 
. TARGET SVSTEM EXECUTING AND WILL HALT THE TARGET SVSTEM 

AND RETURN TO THE USER WHEN A SOFTWARE BREAKPOINT IS HIT. 
. THE SOFTWARE BREAKPOINT PROCEDURES USE TWO ARRAVS DEFINED 
. IN THE USER SVMBOL TABLE. THESE ARRAVS SHOULD NOT BE 
. USED WHEN USir« THE SOFTWARE BREAKPOINT PROCEDURES. 
SBA<8) 
SBI<8> 



NL 

'DEFINING: SOFTWARE BREAKPOINT PROCEDURES' 



. . , DEFINE THE TWO ARRAVS TO BE USED : 

ARRflV SBA<8> . . . SOFTWARE BREflKPOINT 'ADDRESS' ARRAV 

ARRAV SBI<8> ...SOFTWARE BREAKPOINT 'INSTRUCTION' ARRAV 

'.'.'. INITIALIZE THE ADDRESS ARRAV TO 'NO BREAKPOINTS SET' 
PROC INIT <0, 1> FOR LOC 1 = 1 TO 8 DO SBA<LOC 1> = >FFFF 
INIT . . INITIALIZE THE ADDRESS ARRAV 

DELE C'INIT') ..DELETE THIS TEMPORARV PROCEDURE 



NL 

'DEFINING: SB - SET BREAKPOINT' 

'. '. ABSTRACT: SET A BREAKPOINT OR INSPECT ALL OF THE CURRENT 

BRERKPO I NTS 
'. INTERFflCE : SVNTAX : SB C <C<flODRESS> C , <flDDRESS> 3. . . > 1 
IF THE ARGUMENT IS NOT SUPPLIED THEN SB 
LIST THE ADDRESS OF EACH SOFTWARE 
BREAKPOINT AND THE INSTRUCTION AT THAT ADDRESS. 
IF ARGUMENTS 'f<:ADDRESS> > ARE INCLUDED. THEN 
A SOFTWARE BREAKPOINT IS SET AT EACH ADDRESS. 
DIAGNOSTICS: 'BREAKPOINT SET AT HHHH' IS PRINTED FOR 
EACH BREAKPOINT SET. IF THIS MESSAGE IS NOT 
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PRINTED THEN THE BREfiKPOINT TfiBLE IS FULL AND 
THE BREAKPOINT WAS NOT SET. 



PROC SB <0. 3) BEGIN . . . VARIABLE ARQLM1ENTS, THREE LOCAL VARIABLES; 
IF ARG e EQ e THEN BEGIN 
PRINT OUT ALL CURRENTLY SET BREAKPOINTS 
FOR LOC 1 = 1 TO 8 DO BEGIN 
LOC 2 = SBA<LOC 1); 
IF LOC 2 NE >FFFF THEN BEGIN 

(K.OC 2 = SBKLOC 1) . . RESTORE THE INSTRUCTION 
LOC 2:NSi V '; «.0C 2:HI 
9L0C 2 = >10FF . . RESTORE TKC SPIN 
END; 
END; 
END; 
ELSE FOR LOC 2 = 1 TO ARG DO BEGIN 
SET SOFTWARE BREAKPOINT 
FOR LOC 1 = 1 TO 8 DO 

IF SBA<LOC 1> EQ >FFFF THEN BEGIN 

LOC 3 = ARG <LOC 2) . . ADDRESS TO BREAKPOINT 

SBA<LOC 1) '^ LOC 3 . . SAVE THE ADDRESS 

SBKLOC 1> =^ ©LOC 3 . . SAVE THE INSTRUCTION 

©LOC 3 - >10FF 

NL; 'BREAKPOINT SET AT 

ESCAPE 

END; 



SET THE SPIN 
(LOC 3:S 



END; 



END 



NL 

'DEFINING: CB - CLEAR SOFTWARE BREAKPOINT' 

ABSTRACT: CLEAR GIVEN OR ALL SOFTWARE BREAKPOINTS. 

INTERFACE : SYNTAX : CB C «ADDRESS> C , <ADDRESS> 3. . . > 3 
IF <ADDRESS> IS INCLUDED THEN CLEAR THE 
BREAKPOINT AT THAT ADDRESS. IF THER IS NO 
ARGUMENT THEN CLEAR ALL OF THE BREAKPOINTS. 
DIAGNOSTICS: 'BREAKPOINT CLEARED AT HHHH' MESSAGE WILL 

BE PRINTED FOR EACH BREAKPOINT CLEARED. IF THIS 
MESSAGE IS NOT PRINTED A SOFTWARE BREAKPOINT 
WAS NOT FOUND AT THE GIVEN ADDRESS. 



PROC CB <0-2> BEGIN ..VARIABLE ARGUMENTS- TWO LOCAL VARIABLE; 
IF ARG EQ THEN BEGIN 
CLEAR ALL SOFTWARE BREAKPOINTS 

NL; 'CLEARING ALL BREAKPOINTS' 
FOR LOC 1 = 1 TO 8 DO BEGIN 

IF SBA<LOC 1) NE >FFFF THEN BEGIN 
(?SBA<LOC 1> - SBKLOC i> 
SBACLOC 1> = >FFFF 
END 
END, 
END; 
ELSE FOR LOC 2 = 1 TO ARG Q DO BEGIN 
CLEAR SPECIFIED SOFTWARE BREAKPOINTCSJ 
FOR LOC 1 = 1 TO 8 DO 
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IF SBfKLOC 1) EQ flRG <LOC 2) THEN BEGIN 
©SBfl<LOC 1) = SBKLOC 1> 

SBfl<LOC 1) = >FFFF . . CLEflR THE BREfiKPOINT 
NL; 'BREAKPOINT CLEFIRED AT ', 
flRG<LOC 2):S 
ESCAPE 
END; 



ENDj 



END; 



NL 

'DEFINING: EB 



EXECUTE FROM SOFTWARE BREAKPOINT' 



ABSTRACT: EXECUTE FROM SOFTWARE BREAKPOINT 

I NTERFACE : S VNTAX : EB 

THE EB COMMAND STARTS TARGET SYSTEM EXECUTION FROM 
A SOFTWARE BREAKPOINT AND CONTINUES EXECUTION UP 
TO THE NEXT SOFTWARE BREAKPOINT ENCOUNTERED. THE 
INSTRUCTION AT THE ENCOUNTERED SOFTWARE BREAKPOINT 
IS NOT EXECUTED. SOFTWARE BREAKPOINTS ARE SET BV 
THE SB <SET SOFTWARE BREAKPOINT) COMMAND AND CLEARED 
BV THE CB < CLEAR SOFTWARE BREAKPOINT) COMMAND. 



NOTE : NOTE : : NOTE : : NOTE : : NOTE : : NOTE : : NOTE : : NOTE : : NOTE : : NOTE 
EBRUN IS A LOCAL PROCEDURE FOR THE 'EB' PROCEDURE. 
THIS ROUTINE DETERMINES HOW THE HOST SVSTEM STOPS THE 
TARGET SVSTEM ONCE A SOFTWARE BREAKPOINT IS HIT. TWO 
IMPLEMENTATIONS ARE DEFINED BELOW - CHOOSE THE ONE 
WHICH IS APPLICABLE TO THE AMPS HARDWARE VOU HAVE OR 
DEFINE VOUR OWN ROUTINE. VERSION «1 IS INITIALLY 
COMMENTED OUT, ASSUMING THAT THE HAS A TRACE MODULE. 

NOTE: NOTE: :NOTE: :NOTE: :NOTE: :NOTE: :NOTE: :NOTE: :NOTE: :NOTE 

EBRUN - VERSION #1 

- USES ONLV THE EMULATOR MODULE 

- PER I OD I CALL V STOPS THE TARGET SVSTEM TO SEE IF 
IT IS ON A SOFTWARE BREAKPOINT. TRACE CflPABILITV 
OF THE EMULATOR CANNOT BE USED <WILL TRACE SPINS> 

PROC EBRUN <0- 2) BEGIN . . RUN THE TARGET UNTIL SOFTWARE BREAKPOINT 
ETRC<OFF> . . TURN OFF THE TRACE CAPABILITY 
EBRKCOFF, OFF> . . MAKE SURE NOTHING ELSE STOPS US 
LOC 2 = . . BREAKPOINT ENCOUNTERED FLAG 
. . PERIODICALLY STOP THE TARGET UNTIL ON A BREAKPOINT 
REPEAT BEGIN 

. . START THE TARGET SYSTEM 
. . DELAY ONE SECOND 
. . STOP THE TARGET SVSTEM 
1 TO 8 DO 
IF SBA<LOC 1> EQ PC THEN LOC 2 = 1.. SET FLAG TO TRUE 
END UNTIL LOC 2 
. . RETURN TO CALLER 
END 



EBRUN - VERSION #2 

- USES BOTH THE EMULATOR AND LOGIC STATE TRACE MODULES 

- THESE MODULES ARE INITIALIZED TO TRACE ALL ADDRESS 



ERUN 

WAIT<20) 

EHLT 

FOR LOC 1 
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AND DfiTfl PLACED ON THE RESPECTIVE BUSSES OF THE TARGET 
< PROCEDURE TEDUMP MAV BE USED TO EXAMINE THE RESULTS) 

PROC EBRUN <0, 8> BEGIN . . EXECUTE UNTIL SOFTWARE BREAKPOINT HIT 

. . PREPARE THE AMPS HARDWARE - 'USING TRACE AHALVZER- 
TTRC<:DATA+<EMT-1>*Q0. 256, EXT> ..TRACE ALL DATA IN TM 
TCMPCDATA+IAQOIQFF, >FFFF> ..DEFINE 'SPIN AS AN EVENT 
TEVT<1. 0, NORM+EACH+INT> ..COUNT ONE EVENT, ZERO DELAYS 
TBRK<EVT. EMU> . . HALT EMULATOR ON SATISFACTION OF EVT.'DELAV 
ETRCCADDR, 256> EXT> . TRACE ALL ADDRESS IN THE EMULATOR MODULE 
EBRKCOFF. SELF) HALT EMULATOR ON SIGNAL FROM TRACE ANALVZER 

. . START THE TARGET SVSTEM 

TRUN . . START THE TRACE ANALVZER MODULE 

ERUN . . START THE EMULATOR MODULE 

. . WAIT UNTIL EMULATOR HALTS 
WHILE EST AND 1 DO NULL 

. . RETURN TO CALLER 
END 



PROC EB <0,1> BEGIN . . EXECUTE FROM SOFTWARE BREAKPOINT 

. . SEE IF THE PC IS CURRENTLY AT A SOFTWARE BREAKPOINT 
FOR LOC 1 = 1 TO 8 DO 

IF sba<:loc i> eq pc then begin 

PC IS CURRENTLY AT A SOFTWARE BREAKPOINT 
eSBA<LOC 1) = SBKLOC 1> ..RESTORE THE INSTRUCTION 
'SINGLE STEP' THE TARGET SVSTEM PAST THIS BREAKPOINT 
ECMP<IAQ, PC> 
EEVT<INT> 
EBRK<EVT, SELF) 
ERUN 
(?SBA<LOC 1) = M0FF 
ESCAPE 
END 
. . EXECUTE THE TARGET SYSTEM UNTIL A SOFTWARE BREAKPOINT IS FOUND 
NL; 'STARTING THE EMULATOR'; NL 
EBRUN 

NLi 'BREAKPOINT ENCOUNTERED AT ADDRESS: 
. . RETURN TO CALLER 
END 



RESTORE THE SPIN INSTRUCTION 



';PC:H 
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TITLE: SETMEM: SET fl RfiNGE OF MEMORV TO CONSTANT VALUES 
REVISION: 83/24/77 



fiBSTRfiCT ' 

SETMEM WRITES fl SPECIFIED VALUE 
RfiNGE OF TARGET MEMORV. 



INTO EVERV WORD OF A SPECIFIED 



SETMEM HAS THREE ARGUMENTS. THE FIRST TWO SPECIFV THE RANGE OF 
MEMORV TO BE FILLED WITH THE CONSTANT. THE OPTIONAL THIRD ARGUMENT 
IS THE VALUE TO BE WRITTEN INTO MEMORV. I." IT IS OMITTED, ZERO IS 
USED FOR THE VALUE. SETMEM MAV BE CALLED ONLV WHEN THE EMULATOR IS 
HALTED. 

'DEFINING SETMEM' 



PROC SETMEM < 2, 1> BEGIN 
IF ARG EQ 3 

THEN LOC 1 = ARG 3 
ELSE LOC 1=0; 
REPEAT BEGIN 

®ARG 1 = LOC li 
ARG 1 = ARG 1+2; 
END UNTIL ARG 1 HI ARG 2 
END 



VALUE WAS SPECIFIED 
NOT SPECIFIED 

WRITE A WORD 
INCREMENT ADDRESS 



OR ARG 1 EQ 0; 
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TITLE: 
REVISION; 



SIE; SINGLE INSTRUCTION EXECUTION 
06/02/77 



flBSTRHCT : 

SIE LETS THE EMULATOR EXECUTE ONE INSTRUCTION AND HALT. BEFORE 
IT EXECUTES THE INSTRUCTION. SIE PRINTS THE PC AND THE INSTRUCTION 
ABOUT TO BE EXECUTED. IF THE INSTRUCTION HAS A SOURCE < DEST I NAT I ON 5 
OPERAND, SIE PRINTS ITS ADDRESS AND VALUE BEFORE AND AFTER THE 
INSTRUCTION IS EXECUTED. 

USAGE : 

WP. PC, AND ST MUST BE SET CORRECTLV FOR THE INSTRUCTION. 
NORMALLV> SIE MflV BE USED REPEATEDLV TO STEP THE EMULATOR THROUGH 
A PROGRAM ONE INSTRUCTION AT A TIME. 

SIE HAS ONE OPTIONAL ARGUMENT, WHICH SPECIFIES HOW MANV 
INSTRUCTIONS TO STEP THROUGH, ONE AT A TIME, BEFORE SIE RETURNS. 
SIE PRINTS THE INSTRUCTION ABOUT TO BE EXECUTED ON THE FIRST LINE. 
ON TWO MORE LINES SIE PRINTS THE VALUES OF WP, PC, AND ST, AND 
OF THE SOURCE AND THE DESTINATION OPERANDS, BEFORE AND AFTER THE 
INSTRUCTION IS EXECUTED, RESPECTIVELV. IF AN INSTRUCTION HAS 
NO SOURCE OR NO DESTINATION OPERAND, THE DISASSEMBLER SETS THE 
SYSTEM VARIABLE SRC OR DST, RESPECTIVELV, TO -1. IF SIE FINDS 
SRC CDST) EQUAL TO -1 IT ASSUMES THERE IS NO SOURCE < DESTINATION) 
OPERAND AND DOES NOT PRINT THE ADDRESS <-!> OR VALUE BEFORE OR 
AFTER THE INSTRUCTION IS EXECUTED. ON THE FOURTH LINE SIE PRINTS 
THE NEXT INSTRUCTION TO BE EXECUTED, AT THE NEW PC. 

WHEN SIE IS USED, THE EMULATOR COMPARISON LOGIC MAV NOT BE 
USED. THE EMULATOR TRACE LOGIC AND THE TRACE MODULE MAV BE USED, 
BUT ONLV ONE INSTRUCTION WILL BE RECORDED. 

DEFINING LOCAL PROC ZSIESD' 



PROC ZSIESD <&:> BEGIN 

NL ' WP=' WP;H ' PC=' PC : H 
IF SRC NE -1 

THEN BEGIN 

' SRC=' SRC:H '/ " eSRC:H 
END; 
IF DST NE -1 

THEN BEGIN 

' DST=' DST;H '/ - ©DST :H 
END; 
END 



. LOCAL PROCEDURE FOR SIE 
ST=^' ST:H 



NL 

'DEFINING SIE' 



PROC SIE <0, 1) BEGIN 
EEVT<INT>; 
EBRKCEVT, SELF); 
IF ARG EQ 1 

THEN LOC 1 = ARG 1 
ELSE LOC 1 =• 1; 
WHILE LOC 1 GT 
DO BEGIN 

@PC;NI; 

ZSIESD; 

ECMPaAQ, PC>; 

ERUN; 

WHILE <EST AND 1> DO NULL 

ZSIESD; 

LOC 1 = LOC 1-1 



USE INTERNAL EVENT LOGIC 
HALT WHEN NEXT PC EXECUTED 
HOW MANV TIMES TO REPEAT 



CURRENT INSTRUCTION 
LOCAL PROC PRINTS INFO 
BREAK ON THE NEXT PC 
SINGLE-STEP EMULATOR 



ITERATE THE PROCESS 
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END; 

OPC : NXXXXX I ; ... NEXT I NSTRUCT I ON 

EBRKCOFF, OFF> ... TURN SIE STUFF OFF 
END 
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TITLE: 
REVISION: 



ESTflT 
05/02/77 



ABSTRACT : 

ESTfiT USES SVSTEM VfiRIflBLES EST. EN I, ETBO, HHD ETBN TO PRINT 
THE STATUS OF THE EMULATOR MODULE. 

USAGE : 

ESTAT HAS NO ARGUMENTS AND MAV BE CALLED AT ANV TIME. 

'DEFINING ESTAT' NL 

PROC ESTATC0) BEGIN 
-EMULATOR IS ' 
IF <EST AND 1) EQ 8 

THEN 'NOT ' 
'EXECUTING' 
IF EST AND 8 

THEN ' AN IDLE INSTRUCTION' 

NL 'EMULATOR TRACE BUFFER IS ' 
IF <EST AND 2> EQ 

THEN 'NOT ' 
'FULL. ' 

NL 'EVENT CONDITIONS ARE ' 
IF <EST AND 4) EQ 

THEN 'NOT ' 
'SATISFIED. ' 

ENI:NU 'BREAKPOINTS COUNTED. ' 
IF <EST AND 1) EQ 
THEN BEGIN 

ETBN-ETBO+1 : ND 'ADDRESSES TRACED' 
IF ETBN GE ETBO 
THEN BEGIN 

' : ' ETBO:D '. . . ' ETBN:D, 
END 



END 



END 

TITLE: 
REVISION: 



TSTAT: PRINT TRACE MODULE STATUS 
05/02/77 



ABSTRACT : 

TSTAT USES SVSTEM VARIABLES TST, TNE, TNI. TTBO. AND TTBN TO 
PRINT AN ENGLISH DESCRIPTION OF THE STATUS OF THE TRACE MODULE. 



USAGE : 

TSTAT HAS NO ARGUMENTS. 

'DEFINING TSTAT' NL 



IT MAV BE CALLED AT ANV TIME. 



PROC TSTAT C0) BEGIN 
'TRACE MODULE IS ' 
IF <TST AND 1> EQ 8 

THEN 'NOT '; 
'TRACING. ' 

NL 'TRACE BUFFER IS ' 
IF CTST AND 2> EO 

THEN 'NOT 'j , 
'FULL. ' 

NL 'EVENT CONDITIONS ARE 
IF <TST AND 4> EQ 

THEN 'NOT -.1 
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'SfiTISFIED. ' 

TNI:NU 'KiEflKPOINTS COl*<TED. ' 

IF <TST (WD 1) EQ 

THEN BEGIN 

TTBN-TTBO+1 ; ND 'S8MPLES IN BUFFER'; 
IF TTBN QE TTBO 
THEN BEGIN 

' ;' TTBO:D '. . . ' TT8N:D; 
END; 
TNE;NU 'EVENTS COUNTED. ' 
END 
END 
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TITLE. 
REVISION: 



TDRTfl: PRINT TRACE MODULE SAMPLES 
03/24/77 



fiBSTRfiCT : 

TDflTfl PRINTS fl SPECIFIED RfiNGE OF SftMPLES FROM THE TRHCE MODULE 
TRACE BUFFER. THE SAMPLES ARE NOT INTERPRETED.^ ALL TWENTV BITS ARE 
PRINTED FOR EACH SAMPLE. 



USAGE : 

TDATR HAS ONE REQUIRED AND ONE OPTIONAL ARGUMENT. 
ARGUMENT IS THE STARTING INDEX TO BE USED 
ARGUMENT IS THE ENDING INDEX. 
IS THE STARTING INDEX PLUS 29 
THAT MANV IN THE TRACE BUFFER 
TRACE MODULE IS HALTED. 



■DEFINING TDATA' NL 



THE FIRST 
THE OPTIONAL SECOND 
IF IT IS OMITTED, THE ENDING INDEX 
GIVING 30 SAMPLES, IF THERE ARE 
TDATA MAV BE CALLED WHENEVER THE 



PROC TDATR<1, 2> BEGIN 
IF ARG EQ 2 

THEN LOC 1 = ARG 2 
ELSE LOC 1 = ARG 1 + 29i 
IF LOC 1 GT TTBN 

THEN LOC 1 = TTBN; 
LOC 2 = 0; 
' INDEX HIGH LOW HIGH 

HIGH LOW'; 
WHILE ARG 1 LE LOC 1 
DO BEGIN 

IF LOC 2 MOD 3 EQ 
THEN BEGIN 

ARG 1;ND V ' 
END 
ELSE ' 
LOC 2 = LOC 2+1; 
TTBH<ARG 1> :H; 
TTBCARG 1> :HA; 
ARG i = ARG 1+1; 
END; 
E^ND 

TITLE: TFOUR: DISPLAV TRACED SAMPLES 
REVISION: 05/06/77 



. . ENDING INDEX WAS GIVEN 
. . NOT GIVEN 

. . LIMIT ENDING INDEX 
. . SET NEWLINE FLAG 
LOW'; 



START A NEW LINE 

TAB TO NEXT COLUMN 
STEP THE FLAG COUNTER 
DISPLAV SAMPLE 



IN 4-BIT GROUPS 



ABSTRACT : 

TFOUR DISPLAVS A SPECIFIED RANGE OF TRACE BUFFER 
IN GROUPS OF FOUR BITS. 



SAMPLES 



USAGE : 

THE TRACE MODULE MUST BE HALTED AND CONTAIN SAMPLES. TFOUR 
HAS ONE REQUIRED AND ONE OPTIONAL ARGUMENT. THE FIRST ARGUMENT IS 
REQUIRED AND SPECIFIES THE STARTING INDEX. THE SECOND ARGUMENT IS 
OPTIONAL AND SPECIFIES THE ENDING INDEX. IF IT IS OMITTED, START+ 
9 IS USED. 

DEFINING TFOUR' NL 



C TFOUR <:i, 2> BEGIN 




IF ARG GE 2 




THEN LOC 1 


= ARG 2 


ELSE LOC 1 


= ARG 1 + 9; 


' INDEX 0123 


4567 8901 2345 


FOR ARG 1 = ARG 


1 TO LOC 1 DO BEGIN 



b .• By 



4S26' NL; 
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8RG 1:D5> LOC 2 = TTBCRRG l)j 

TTBH<HRG 1) .B4; 

MOR = 0; DIVOieee, LOC 2);B4i 

<LOC 2 AND >0F00) / >100:B4> 

<LOC 2 RND >00F0> / >10:B4; 

LOC 2 RND >eeeF:64; 

TTBH<fiRQ l>:Hlj 

LOC 2:HN; 

END; 
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TITLE: TIMER: TRftCE MODULE TIMING OF EMULATOR 
REVISION: 03/24/77 

fiBSTRflCT : 

THIS ROUTINE SETS THE TRACE MODULE TO STRRT TIMING WHEN 
THE EMULATOR IS NEXT STARTED. IT MAV BE CALLED AGAIN WHILE 
THE EMULATOR IS RUNNING OR AFTER THE EMULATOR HAS HALTED TO 
PRINT THE ELAPSED TIME SINCE THE EMULATOR WAS STARTED. 
COMPUTED FROM THE EVENT COUNTER. THE DELAY COUNTER. AND 
THE NUMBER OF INTERRUPTS GENERATED 8V THE TRACE MODULE. 
THE TRACE MODULE MAV NOT BE USED FOR TRACING WHILE IT 
IS BEING USED FOR TIMING. BUT THE EMULATOR MAV TRACE. 
THE TIMING IS ACCURATE TO 108 NANOSECONDS WHEN THE EMULATOR 
HAS HALTED. AND TO 6. 5 MILLISECONDS WHILE THE EMULATOR IS 
RUNNING. 

USAGE : 

THE CONTROL CABLE MUST CONNECT THE EMULATOR AND TRACE MODULE. 
NO OTHER TRACE MODULE COMMANDS SHOULD BE USED WHEN TIMER IS 
BEING USED. IF THE TRACE MODULE IS NOT RUNNING. TIMER WILL 
SET IT UP FOR TIMING AND START IT. 

THE PRESENCE OF THE OPTIONAL ARGUMENT SUPPRESSES THE 
PRINTING OF ELAPSED TIME. THIS ARGUMENT <ANV VALUE 
WILL D0> CAN BE USED WHEN TIMER IS BEING CALLED FOR .THE 
FIRST TIME IN A SERIES OF TIMINGS. TO SET THE TRACE 
MODULE UP WITHOUT PRINTING MEANINGLESS TIMING INFORMATION. 
FOR EXAMPLE. 



? TIMER<0) 

? ERUN 
? TIMER 

1 234 



? TIMER 
1 



rss 



< ARGUMENT SUPPRESSES PRINTING:i 
(COMMANDS TO SET UP EMULATOR > 
< AFTER SETTING UP EMULATOR;- 
< EMULATOR MAV STILL BE RUNNINGS 
J67 800 SECONDS. STILL TIMING 

(EMULATOR HALTS ITSELF. OR EHLT IS GIVEN) 
<NOW EMULATOR IS NOT RUNNING) 
12 300 SECONDS 



DEFINING TIMER' 
PROC TIMER<0. 7> BEGIN 
VRR 



LOC 1 
LOC 2 
LOC 3 
LOC 4 
LOC 5 
LOC 6 
LOC 7 



FIRST SCRATCH. THEN NUMBER OF SECONDS ELAPSED. 

MILLESECONDS. 

MICROSECONDS. 

NANOSECONDS (ACCURATE TO 180 NSX 

SCRATCH. 

SCPflTCH 

NUMBER OF EVENTS. IF TRACE IS HALTED; 

IF TRACE IS RUNNING. 



IF THE OPTIONAL ARGUMENT IS NOT PRESENT. COMPUTE ELAPSED 
TIME AND PRINT IT. 

IF ARG EQ 

THEN BEGIN 

. . IF THE TRACE MODULE IS ^HALTED. THEN USE NUMBER OF EVENTS. 
. . OTHERWISE. USE ZERO AND GET APPROXIMATE ELAPSED TIME ONLY. 

IF TST AND 1 
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THEN 



ELSE 



LOC 7 = 
LOC 7 = TNEi 



EACH THREE DIGITS OF THE ELAPSED TIME RIGHT OF THE DECIflflL 
POINT RRE COMPUTED SEPfiRflTELV. STRRTING WITH NANOSECONDS. 
THE WHOLE FORMULA FOR THE ELAPSED TIME IS 

T = <65536 * TNI + TNE> * 1. 0E-07 
BECAUSE TNE IS INCREMENTED EACH 180 NS, AND TNI IS INCREMENTED 
EACH 65,536 TIMES TNE IS INCREMENTED. 

THE NANOSECONDS POSITIONS ARE COMPUTED BV 

D9 » 600 * TNI + 100 * TNE 
AND PRINTED WITH 

D9 <MOD 1000> <ONLV THE LOW-ORDER THREE DIGITS). 

THE MICROSECONDS POSITIONS ARE COMPUTED BV 

D6 = 553 * TNI + <D9 DIV 1000> 
WHERE "DIV IS INTEGER DIVISION, SO <D9 DIV 1000> IS THE CARRV 
FROM THE NANOSECONDS COMPUTATION INTO THE MICROSECONDS POSITION. 
AND PRINTED WITH 

D6 <MOD 1000>. 

THE MILLISECONDS POSITIONS ARE COMPUTED BV 

D3 = 6 * TNI + <D6 DIV 1000) 
AND PRINTED WITH 

D2 <MOD 1000). 

THE SECONDS POSITIONS, TO THE LEFT OF THE DECIMAL POINT, ARE JUST 
IVS. EXCESS IN D3 OVER 1M0, VIZ. - 

D3 DIV 1000, 
AND MAV BE ABOUT AS LARGE AS 400 < 6 OR 7 MINUTES) BEFORE OVERFLOW 
AND INFORMATION LOSS OCCURS. THUS THIS ROUTINE MAV BE USED TO 
TIME EMULATOR RUNS OF MOST INTERESTING LENGTHS. 



LOC 4 « MPV<100, LOC 7)j 




LOC S » MDR; 




LOC 6 = MPV<6a0, TNDi 




LOC 5 = r«)R + LOC Si 




LOC 6 = LOC 4 + LOC 6i 




MDR = MDR + LOC 0; 




LOC 5 = DIV<1000,LOC 6); . 


. . CARRV INTO MICROSECS 


LOC 4 = MDR; 


. . NANOSECS 



LOC 3 = MPV<553, TNI); 

LOC 6 = MDR; 

LOC 3 = LOC 3 + LOC 5; 

MDR = MDR + LOC 6; 

LOC 6 = DIV<1000, LOC 2>; 

LOC 3 - ^tt)R; 



CARRV INTO MILLISECS 
MICROSECS 



LOC 2 «= MPV<6,TNI); 
LOC 1 = r«)R; 
LOC 2 » LOC 2 + LOC 6; 
MDR = LOC 1 + WR; 
LOC 1 = DIV<10e0, LOC 2 
LOC 2 = MDR; 



CARRV INTO SECS 
MILLISECS 



PRINT THE RESULT, AT LAST. 
LOC 1:D; 



SECONDS 
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' '; ... DECIMfiL POINT 

LOC 2:D, ... MILLISECONDS 

LOC 3:D; ...MICROSECONDS 

LOC 4 : D> ... NANOSECONDS 
'SECONDS' 

IF THE TRACE MODULE IS NOT HALTED, INDICATE SO. 

IF TST AND 1 

THEN BEGIN 

', STILL TIMING'; 
RETURN 
END; 
END 

WHETHER THE OPTIONAL ARGUMENT IS THERE OR NOT, IF THE TRACE 
MODULE IS HALTED, SET IT UP FOR THE NEXT TIMING RUN. 

IF <TST AND 1> EQ 
THEN BEGIN 

TTRCCOFF, 256, INT>; 
TCMPCOFF, 0, 0>; 
TEVTO, 0, INT+EACH+NORM>; 
TBRKCEVT, OFF>; 
TRUN; 
END 
END 
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TITLE; TRACE: DISPLAY TRACE DATA IN TIME DOMAIN 
REVISION: 03/25/77 

ABSTRACT : 

TRACE DISPLAYS THE DATA IN THE TRACE BUFFER IN fl 
FORMAT SIMILIAR TO A LOGIC STATE ANALYZER 

USAGE: 

ARGUMENT 1 IS THE INDEX TO TTB TO PUT ON THE LEFT OF THE DISPLAY 

. . . THE DEFAULT VALUE IS TTBO 

ARGUMENT 2 IS THE FIRST BIT TO BE DISPLAYED 

. . , THE DEFAULT VALUE IS 

ARGUMENT 3 IS THE LAST BIT TO BE DISPLAYED 

. . . THE DEFAULT VALUE IS 19 

ARGUMENT 4 IS THE SCALE FACTOR 

. . . THE SCALE WILL DEFAULT TO 1 MARK/BIT NEGATIS/E SCALES 

. . . ARE TAKEN AS BITS/MARK 



DEFINING TRACE PROCEDURE PLEASE WAIT'; 

PROC TRACE <0-ll> BEGIN ...PRINT OUT TIMING DIAGRAM 
LOC 1 IS THE FIRST INDEX TO TTB 
LOC 2 IS THE FIRST BIT TO DISPLAY 
LOC 3 IS THE LAST BIT TO DISPLAY 
LOC 4 IS THE SCALE FACTOR IN MARKS/BIT 
LOC 5 IS THE INDEX TO TTB 
LOC 6 IS THE MASK FOR EACH BIT 
LOC 7 IS THE SCALE COUNTER 
LOC 8 IS THE MAXIMUM II«>EX TO TTB 
LOC 9 IS THE VALUE TO MASK OFF FOR EACH BIT 
LOC 10 IS THE PREVIOUS VALUE OF LOC 9 
LOC 11 IS fl FLAG FOR NEGATIVE SCALES 



SET UP DEFAULT VALUES 
IF ARG GE 1 THEN LOC 1=ARG 1; ELSE LOC l=TTBOi 
IF ARG GE 2 THEN LOC 2=ARG 2j ELSE LOC 2=0; 
IF ARG GE 3 THEN LOC 3=ARG 3; ELSE LOC 3=19i 
IF ARG GE 4 THEN LOC 4=ARG 4; EL^ LOC 4=1; 
IF LOC 4 LE THEN 
LOC 8=L0C l+<60*<-LOC 4>); ELSE 

LOC 8=L0C l+<60/LOC 4); ... INDEX ON RIGHT SIDE OF DISPLAY 
. . . PRINT HEADER 
NL 

TRACE BIT * AMPL LOGIC STATE ANALYZER * INDEX'; LOC 1:D; 'TO ; 
IF LOC 8 LE TTBN THEN LOC 8 D; ELSE TTBN:D; 
' EMU BIT';NL; 

IF LOC 2 LT 4 THEN LOC S=4-L0C 2; ELSE LOC 5=^1S-<L0C 2-4 >; 
LOC 6=1 

WHILE LOC 5 GT 1 DO BEGIN 

LOC 6=L0C 6*2; ... INITIALIZE MASK TO PROPER VALUE 
LOC 5-LOC 5-1; 
END; 
. . . SCAN A PAGE 

WHILE LOC 2 LE LOC 3 DO BEGIN 

LOC 2:D ... PRINT OUT BIT NUMBER 

LOC S=LOC 1; 

LOC 7=1; ' 

. . SCAN A LINE 

IF LOC 4 GT THEN 
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WHILE LOC 5 LT LOG 3 DO BEGIN 

IF <LOC 5 GE TTBO> AND CLOC 5 LE TTBN> THEN 

IF LOC 2 LT 4 THEN LOC 9=TTBH<L0C 5>^ ELSE 

LOC 9=TTB<L0C 5>; 

. . . PRINT OUT BIT STATE 

IF <LOC 6 AND LOC 9> EQ 8 THEN . . . HIGH OR LOW? 

'_'; ... LOW STATE 

ELSE 

'-'; . . . HIGH STATE 

. . . POSITIVE SCALE FACTOR 

IF LOC 7 GE LOC 4 THEN BEGIN 

LOC 5=L0C 5+li . . . INCREMENT WORD INDEX 
LOC 7=0; . . . RESET SCALE COUNTER 
END; 

LOC 7=L0C 7+1; . . . INCREMENT SCALE COUNTER 
END; 
ELSE . . . NEGATIVE SCALE FACTOR 
WHILE LOC 5 LT LOC 8 DO BEGIN 
LOC 7=-l; 

LOC 11=0; . • . RESET HIGH AND LOW FLAG 

WHILE LOC 7 GE LOC 4 DO BEGIN 
LOC 10=LOC 9 

IF <LOC 5 GE TTBO> AND <LOC 5 LE TTBN> THEN 
IF LOC 2 LT 4 THEN LOC 9=TTBH<L0C 5>; ELSE 
LOC 9=TTB<L0C 5>; 
ELSE LOC 11=2; 
LOC 9=L0C 9 AND LOC 6; 
IF LOC 7 EQ -1 THEN LOC 10=LOC 9 
IF LOC 10 NE LOC 9 THEN LOC 11=1 
LOC 7=L0C 7-1; . . . DECREMENT SCALE COUNT 
LOC 5=L0C 5+1; . . . INCREMENT INDEX 
END; 

. . , PRINT OUT BIT STATE 

IF LOC 11 EQ 1 THEN 'X'; ELSE . . . NOT CONSTANT HIGH OR LOW 
IF LOC 11 EQ 2 THEN ' '; ELSE . . . OUT OF ARRflV BOUNDS 
IF LOC 9 EQ THEN . . . HIGH OR LOW? 
' -•; ... LOW STATE 



ELSE 

> 

END; 



HIGH STATE 



IF LOC 2 GE 4 THEN 

LOC 2-4 D; . . . PRINT OUT BIT NUMBER WITH RESPECT TO EMULATOR 

ELSE IF LOC 2 EQ 01 THEN ' lAQ'; . . . LABEL STATUS BITS 

ELSE IF LOC 2 EQ 02 THEN ' DBIN'; 

ELSE IF LOC 2 EQ 03 THEN - EMU CMP'; 

IF LOC 2 NE LOC 3. THEN BEGIN 

LOC 6=L0C 6/2; . . . MASK FOR NEXT LINE 

NL; ... NEW LINE 

END; 

LOC 2=L0C 2+1; . . . INCREMENT LINE COUNT 

IF LOC 2 EQ 4 THEN LOC 6=>8000; . . . RESET BIT MASK 
END; 



END 
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. . . TITLE: TRfiCE MODULE SAMPLE VERIFICflTION 
...REVISION: e3/06/7V 

flBSTRflCT ' 

THESE TWO ROUTINES RECORD ft TRACE MODULE TRACE BUFFER FULL OF 
SAMPLES ON R FILE AND THEN COMPARE THEM TO A SUBSEQUENT BUFFER FULL 
OF SAMPLES FOR CONSISTENCY. THE COMPARISON IS SUBJECT TO AN OPTIONAL 
. . . BIT MASK. 

. . . USAGE : 

THE TRACE MCK)ULE MUST BE HALTED AND CONTAIN SAMPLES IN ITS 
. . BUFFER TO USE EITf«R OF THESE PROCEDURES. TSAVE HAS ONE 
. ARGUMENT, THE ACCESS NAME OF THE FILE ON WHICH THE CONTENTS OF THE 

TRACE BUFFER WILL BE SAVED. TVRFV HAS ONE REQUIRED ARGUriENT AND 
. TWO OPTIONAL ARGUMENTS. THE FIRST ARGUMENT ■ MUST BE THE ACCESS NAME 
OF THE FILE CONTAINING T>« TRACE SAMPLES SAVED BV TSAVE. THE SECOND 
. . AND THIRD ARGUMENTS GIVE THE HIGH AND LOW-ORDER BIT MASKS. 
... IF THE SECOND ARGUMENT IS OMITTED THE MASK >F IS USED. IF THE THIRD 

ARGUI«NT IS OMITTED, THE MASK >FFFF IS USED FOR THE LOW-ORDER PART 
. . . COMPARISION. THE SAMPLES ARE COMPRED IN SEQUENCE. ANV DIFFERENCES 
. . . ARE PRINTED. 

-DEFINING TSAVE' NL 
PROC TSAVE <1, 1) BEGIN 

' . TURN OFF THE CONSOLE SO THE LISTING TO THE FILE WILL GO FASTER. 

CNSL<OFF); 

'. '. OPEN THE FILE FOR LISTING AND WRITE THE TRACE BUFFER LIMITS. 

LIST<ARG 1> 

TTBO : DN; TTBN : OUi 

^ ;' WRITE ALL THE SAMPLES FROM THE BUFFER, HIGH FOUR BITS FIRST, 
. . FOLLOWED BV LOW SIXTEEN BITS OF EACH SAMPLE. 

FOR LOC 1 = TTBO TO TTBN DO BEGIN 

TTBH<LOC 1):H1N; TTB<LOC l):HNi 
END; 



. . . TURN THE CONSOLE BACK ON AND THE LISTING FILE OFF. 

CNSL<ON>; 
LIST<'DUMV'>; 
LIST<:OFF>; 
END 

'DEFINING TVRFV NL 

PROC TVRFV <1, 10) BEGIN 
CLSEj 

'. '. OPEN THE FILE AND SET UP THE MASKS IN LOC 9 AND LOC 19. 

OPEN<ARG 1> 
IF ARG GE 2 

THEN LOC 9 = ARG 2 

ELSE LOC 9 = 5F; 
IF ARG GE 3 

THEN LOC 10 = ARG 3 

ELSE LOC 10 = >FFFF, 
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READ THE TRRCE BUFFER LIMITS RND COMPftRE TO THE CURRENT LIMITS. 

LOC 1 = READ; 
LOC 2 = READ; 

IF LOC 1 NE TTBO OR LOC 2 NE TTBN 
THEN BEGIN 

'FILE HAS ' LOC 2-LOC 1+1 ;D3 'SAMPLES. ' 

LOC 1:D2 '. . . ' LOC 2 : D3 NL 

'TRACE BUFFER HAS ' TTBN-TTBO+1 : D3 'SAMPLES. ' 

TTB0:D3 '. . . ' TTBN:D3 NL 

END; 

LOOP THROUGH THE FILE AND THE TRRCE BUFFER COMPARING SAMPLES. 
. LOC 1 AND 3 MILL BE USED FOR INDICES. 

LOC 3 = TTBO; LOC 8=0; 

WHILE LOC 1 LE LOC 2 AND LOC 3 LE TTBN DO BEGIN 
LOC 4 = READ; LOC 5 = READ; 
LOC 6 = TTBH<LOC 3); LOC 7 ^ TTB<LOC 3); 
IF <LOC 4 AND LOC 9> NE <LOC 6 AND LOC 9) 
OR <LOC 5 AND LOC 10 > NE <LOC 7 AND LOC 10) 
THEN BEGIN 

IF LOC 8 EQ 

THEN BEGIN 

NL ' FILE TRACE BUFFER '; 

DIFFERENCE' NL; 
LOC 8 = 1; 
END; 
LOC 1:D3; LOC 4: HI; LOC 5.H; 
LOC 3:D3; LOC S.HI; LOC 7:HXX; 
<<LOC 4 AND NOT LOC 6> OR <NOT LOC 4 AND LOC 6>> 

AND LOC 9: HI; 
<<LOC 5 RND NOT LOC 7> OR <NOT LOC 5 RND LOC 7>> 

AND LOC 10:HN; 
END; 
LOC 1 = LOC 1+1; LOC 3 = LOC 3 + 1> 
END; 
CLSE; 
END 
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APPENDIX I 
GLOSSARY 



This glossary contains definitions of terms used in the manual, some of which are defined in 
greater detail in other manuals. 

AMPL Microprocessor Prototyping Laboratory — A combination of hardware and software that 
executes in an FS990 or DS990 to develop prototype hardware and software. 

AMPL Microprocessor Prototyping Language - The language with which the user communicates 
with the AMPL system. When host memory consists of more than 16K words, an extended 
AMPL may be used, providing additional capabilities. 

Assembler - A computer program that develops a computer program by assembling machine 
instructions from source program statements. The computer program output by the assem- 
bler is called the object program. 

Breakpoint - The result of a computer reaching a predefined program condition or set of 
program conditions. Typically (but not necessarily) a breakpoint halts the computer. 

Buffer Module - The hardware module that interfaces between the emulator module and the 
target computer. A buffer module adapts the emulator module to emulate a specific 
microprocessor, i.e., a TMS 9900 buffer module is required to interface the emulator to a 
target computer that uses a TMS 9900 microprocessor. 

Data Probe — A connector that connects a single line to a point on a module or printed circuit 
board for test purposes. The trace module may be connected to desired points on the target 
system using a set of data probes. 

Delay Counter - A counter on the trace module that counts a specified number of traced items 
to delay the breakpoint signal. The delay counter begins to count when the event counter 
has counted the specified number of events. 

Emulator - A module that connects to a host computer at the CRU interface and to a target 
computer through the appropriate buffer module. The host computer controls the emulator 
as a peripheral device causing the emulator to control the target system for test purposes. 
The emulator includes memory that can be used as target system memory. 

Event — In the emulator, an event is a valid comparison between an address and a specified 
value. Alternatively, an external signal may be defined as an event. In the trace module, an 
event is a valid comparison between a value being stored in the trace memory and a 
specified value. The trace module may also use an external signal as an event. 

Event Counter — A counter in the trace module that counts events. The event counter in 
conjunction with the delay counter allows the user to specify a count of events and a delay 
count after which a breakpoint may occur. 
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Floppy Disc - A data storage device that stores data magnetically on the surface of a flexible 
disc (diskette). The floppy disc accesses data randomly. 

Format Specification - A set of one or more characters (table 4-2) preceded by a colon (:) used 
in a display statement to specify the format of the display. Format specification characters 
are effective in the order in which they are entered; they control conversions to decimal, 
hexadecimal, or octal values, or display in binary form or in ASCII character form. Other 
format specification characters insert spaces or carriage returns. 

Function - An AMPL subroutine that is called by entering the function name and arguments as 
a variable in an AMPL expression or statement, and which returns a value that is used as 
the value of the variable. 

Host Computer - The Model 990 Computer in which the AMPL Microprocessing Prototyping 
Laboratory software executes to control the microprocessor of a target system. 

Host Memory - The memory of the host computer. 

Host System - The AMPL Microprocessor Prototyping Laboratory system as it functions to 
control and test a target system. 

Link Utility - A computer program (TXLINK) that integrates object modules into a linked 
object module (load module). Typically each module requires addresses of labels defined in 
other modules (external references) and defines labels required in other modules (external 
definitions). Linking consists of satisfying the external references in a set of modules from 
the external definitions of these modules. 

Mask - A mask is used in a comparison between words or groups of bits to select the bits to be 
compared. The mask of a word comparison contains 16 bits and the mask of a comparison 
of a group of bits contains the number of bits in the group to be compared. Comparisons 
of qualifiers and stored values in the trace module are masked, allowing the user to select 
the bits for comparison. 

Procedure - An AMPL subroutine that is called by entering the procedure name and arguments 
as an AMPL statement. All transfer of data to or from the procedure is through arguments. 

Program Counter - An internal register in a computer or microprocessor of the 990 family 
which contains the address of the next instruction to be executed. 

Programmable Read-Only Memory - A memory device that may only be read which is 
programmed with the information (instructions and constants) it requires. 

PROM - Programmable Read-Only Memory. 

Quahfiers - A set of four hnes connected to the trace module that selects the clocks at which 
values are stored. The user specifies bit values to which the qualifiers are compared and a 
mask that selects which quahfiers are compared. 

RAM " Random Access Memory. 
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Random Access Memory — A memory device that may be accessed for either reading or writing 
data. Addresses may be accessed randomly. 

Read-Only Memory - A memory device that may only be read. The information (instructions 
and constants) is stored in memory v^^hen it is manufactured. 

Status Register - An internal register in a computer or microprocessor of the 990 family that 
contains status bits set and reset to show the results of executing instructions, and the 
interrupt mask. 

Target Program - The program to be executed by the target system computer. 

Target System - The prototype system under test by the AMPL system. 

Target System Memory - The memory of the target system. The emulator can map either the 
program memory or the trace memory, or both, into target system memory. 

Terminal Executive Development System - A program development system that supports an 
assembler (TXMIRA), a Text Editor (TXEDIT), a Link Utility (TXLINK), and other 
utihties and executes in the FS990. 

Text Editor - A computer program (TXEDIT) that writes source files from user input, and 
allows the user to interactively edit the source files. 

TMS 9900 - A microprocessor of the 990 family, using a single chip, and N-channel sihcon-gate 
MOS technology. A 16-bit processor using 16-bit memory access, with byte addressing. 

TMS 9980 - A microprocessor of the 990 family, using a single chip, and N-channel silicon-gate 
MOS technology. A 16-bit processor using 8-bit memory access, with byte addressing. 

Trace - In the emulator module, an operation that stores up to 256 addresses during emulation 
as specified by the user. In the trace module, an operation that stores up to 256 20-bit 
values as specified by the user. The 20 bits may be data from selected points on a 
prototype module, or may be either memory addresses or data from the emulator. The user 
may display the values stored in either the trace memory of the emulator or in the memory 
of the trace module. 

Trace Memory - A 256-word memory in the emulator which is used by the emulator to store 
traced addresses. Trace memory is also available to the target system. When the target 
system uses trace memory, addresses FE00i6 through FFFFie of target system memory 
space address the trace memory. 

Trace Module -- A module that connects to a host computer at the CRU interface and to the 
target computer or the emulator. The trace module may operate in conjunction with or 
independently of the emulator to store selected data and to compare stored data to 
specified criteria. The trace module may stop the trace when the specified number of values 
has been stored, or when a specified number of vahd comparisons have been made, and a 
specified number of addifional values has been stored. Alternatively, either of these con- 
ditions may cause the trace module to request the emulator to halt, or may interrupt the 
host computer. 
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ALPHABETICAL INDEX 
INTRODUCTION 



The following index lists key words and concepts from the subject material of the manual 
together with the area(s) in the manual that supply major coverage of the hsted concept. The 
numbers along the right side of the listing reference the following manual areas: 

• Sections - References to Sections of the manual appear as "Section x" with the symbol 
X representing any numeric quantity. 

• Appendixes - References to Appendixes of the manual appear as "Appendix y" with the 
symbol y representing any capital letter. 

• Paragraphs - References to paragraphs of the manual appear as a series of alphanumeric 
or numeric characters punctuated with decimal points. Only the first character of the 
string may be a letter: all subsequent characters are numbers. The first character refers 
to the section or appendix of the manual in which the paragraph is found. 

• Tables - References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number: 

Tx-yy 

• Figures - References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number: 

Fx-yy 

• Other entries in the Index - References to other entries in the index are preceded by 
the word "See" followed by the referenced entry. 
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Address and Data Bus 

Checkout, Target System 3.2.2 

Address Mapping, Target Memory . . 4.5.5.4, F4-1 

Addressing Example, Indirect 4.5.5.4 

Altering Format Specifications 4.6.3.3 

Alternate Qualifier Keywords T5-3 

AMPHDT Procedure 5.3, FH-1 

AMPL: 

Grammer Appendix C 

Language Introduction 3.1.8.1 

Microprocessor Prototyping 

Laboratory F2-1 

Procedure and Function Library Appendix H 

Reserved Words Appendix E 

Statement Summary Appendix D 

Application, Prototyping Laboratory 3.3 

ARC Operator 4.7.3 

Arguments 4.7.3 

Arithmetic Operators 4.5.2 

Array: 

Reference 4.6.2 

Statement 4.6.1 

Arrays 4.2.4 

Assign Statement 4.6.2 

AT, Procedure FH-3 

Binary Constants 4.2.2.4 

BL, Procedure FH-9 

BLWP, Procedure FH-9 

Breakpoint: 

Comparison F3-1 

Emulator Trace F3-2 

Trace Module Trace F3-3 

Buffer Module F2-19 

Checkout 3.2.1 

Clock Switch 3.2.1, 3.2.3, 5.4 

Cable Connections 2.2.3 

Emulator F2-16 

Cables: 

Emulator/ Buffer 2.2.3.1 

Trace Module F2-4 

Cabling Diagram, Emulator/ Buffer .... F2-14 

Calls: 

Function 4.7.6 

Procedure 4.7.6 

CASE Statement 4.6.5 

CB, Procedure FH-10 

CC, System Variable 4.6.3.2, 4.7.7 

Character: 

Constants 4.2.2.5 

Set 4.2.1 

Strings 4.2.5 

Characters, Format Specification T4-2 



Chassis Configuration: 

CRU Expansion F2-1 1 

DXIO, Model 990/10 Computer F2-9, F2-10 
TX990, Model 990/4 Computer . F2-5, F-27 
TX990, Model 990/ 10 Computer . F2-6, F2-9 

Checking Program Results 7.9 

Checkout: 

Buffer Module 3.2.1 

Target System: 

Address and Data Bus 3.2.2 

Clock 3.2.3 

Memory 3.2.4 

Checks, Initial 3.2 

Circuit Board Installation 2.2.2 

Clear Test Environment Command .... 5.7.11 

Clock Checkout, Target System 3.2.3 

Clock Switch: 

Buffer Module 3.2.1, 3.2.3, 5.4 

Close Command 5.9.4 

CLR Command 3.1.2,5.7.11 

CLSE Command 5.9.4 

CMD Key 5.5 

CNSL Command 5.7.1 

Command Characters, Display and Modify T4-3 
Command: 

Close 5.9.4 

CLR 3.1.2,5.7.11 

CLSE 5.9.4 

CNSL 5.7.1 

COPY 3.1.2,3.2.1,5.7.14 

CRU Read 5.8.1 

CRU Write 5.8.2 

CRUR 5.8.1 

CRUW 5.8.2 

Define Console 5.7.1 

Define Listing Device 5.7.2 

Define Trace Breakpoint 5.1 1.2 

Delay AMPL Execution 5.7.16 

DELE 5.7.15 

Delete 5.7.15 

Delete Load Module Symbol 

Table 5.7.8 

Display Load Module Symbol 

Table 5.7.7 

Display Register 5.7.5 

Display System Symbol Table 5.7.9 

Display User Symbol Table 5.7.6 

DIV 5.7.4 

Divide 5.7.4 

DR 5.7.5, 7.5 

DUMP 5.6.2 

EBRK 3.1.1,3.3, 5.10.2,7.5, 

7.7, 7.10 

ECMP 3.1.1,3.3, 5.10.4, 7.5, 

7.7, 7.9, 7.10 
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EDIT 5.7.13 

EEVT 3.1.1, 3.3, 5.10.3, 7.5, 7.10 

EHLT 3.1.1, 3.2.1, 3.2.2, 3.2.3, 

3.2.4, 5.10.7 

EINT 3.1.1, 3,2.1, 3.2.3, 5.10.1, 7.3 

Enter Text Editor 5.7.13 

EOF 5.9.3 

ERUN 3.1.1,3.2.1,3.2.2,3.2.3,3.2.4 

3.3. 3.4, 5.10.6, 7.5, 7.6, 7.9, 7.10 

ETB 4.7.7, 5.10.8 

ETRC 3.1.1,3.3,5.10.5.7.5,7.7,7.10 

EXIT 5.7.19 

HCRR 5.8.3 

HCRW 5.8.4 

Host CRU Read 5.8.3 

Host CRU Write 5.8.4 

Initialize Compare Logic 5.10.4 

Initialize Emulator 5.10. 1 

Initialize Trace Compare Logic 5.11.4 

Initialize Trace Logic 5.10.5 

Initialize Trace Module 5.11.1 

Initialize Trace Module Trace 

Logic 5.11.5 

LIST 3.1.2, 5.7.2 

LOAD 5.6.1, 7.3 

MDEL 5.7.8 

MPY 5.7.3 

MSYM 5.7.7 

Multiply 5.7.3 

New Line 5.7.17 

NL 5.7.17 

OPEN 5.9.1 

READ 5.9.2 

Read High Order Trace 

Module Memory 5.11.9 

Read Low Order Trace 

Module Memory 5.11.8 

Read Trace Memory 5.10.8 

Restore Test Environment 5.7.12 

RSTR 5.7.12 

SAVE 5.7.10 

Save Test Environment 5.7.10 

Select Event 5.10.3 

Select Trace Event 5.1 1.3 

SSYM 5.7.9 

Start Microprocessor 5.10.6 

Start Trace 5.1 1.6 

Stop Microprocessor 5.10.7 

Stop Trace 5. 1 1 .7 

TBRK 3.1.2,3.3,3.4,5.11.2,7.10 

TCMP 3.3, 3.4, 5.11.4 

Terminate AMPL Program 5.7.19 

TEVT 3.3, 3.4, 5.11.3 

THLT 5.11.7 

TINT 3.1.2, 5. II. I, 7.10 

TRUN 3.3.3.4, 5.11.6,7.10 



TTB 5.11.8 

TTBH 5.11.9 

TTRC 3.1.2, 3.3, 3.4, 5.11.5, 7.10 

USYM 5.7.6 

Verify 5.7.18 

VRFY 5.7.18 

WAIT 5.7.16 

Commands: 

CRU 5.8 

Data Input 5.9 

Emulator Control 3.1.1 

Emulator Operation 5.10 

Entering 5.5 

Program 5.6 

Trace Module 3.1.2 

Trace Module Operation 5.1 1 

User Appendix G 

Utility 5.7 

Comments 4.2.6 

Comparison Breakpoint F3-1 

Components, System 2.1.2, T2-I 

Compound Statement 4.6.9, 7.4 

Computer Chassis 
Configuration: 

DXIO, Model 990/10 F2-9 

TX990, Model 990/4 F2-5, F2-3 

TX990, Model 990/10 F2-6, F2-9 

Installation 2.2.1 

Configuration: 

CRU Expansion Chassis F2-11 

DXIO, Model 990/ 10 Computer F2-9, F2-10 

Software i.4 

System 2.1.1, Fl-2, F2-2 

TX990: 

Model 990/4 Computer F2-5, F2-7 

Model 990/ 10 Computer F2-6, F2-9 

Connection Modification, Interrupt .... 2.2.1.2 
Connections: 

Cable 2.2.3 

Emulator Cable F2-16 

Target System 2.2.3.2, F2-22 

TMS 9900 Target System F2-I7 

TMS 9980 Target System F2-I8 

Trace Module 2.2.3.3, F2-20 

Constants 4.2.2 

Binary 4.2.2.4 

Character 4.2.2.5 

Decimal 4.2.2.1 

Hexadecimal 4.2.2.2 

Instruction 4.2.2.6 

Octal 4.2.2.3 

Contents: 

TMS 9980, Trace Memory F5-3 

Trace Memory F5-2 

Copy Command 3.1.2,3.2.1,5.7.14 

CRU Commands 5.8 
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CRU Expansion Chassis Configuration . F2-II 

CRU Read Command 5.8.1 

CRU Write Command 5.8.2 

CRUB, System Variable 5.8.1 

CRUR Command 5.8.1 

CRUW Command 5.8.2 

Cycle, Prototype Development 1.2, Fl-1 

Data Input Commands 5.9 

Data Probe Terminator and Leads .... F2-21 

DAY, System Variable 5.5 

DEBUG Procedure Documentation .... FH-4 

Debugging, Initial 7.4 

Decimal Constants 4.2.2. 1 

Define Breakpoint Conditions Command 5.10.2 

Define Console Command 5.7.1 

Define Listing Device Command 5.7.2 

Define Trace Breakpoint Command ... 5.11.2 
Delay AMPL Execution Command . . . 5.7.16 

DELAY Procedure FH-3 

DELE Command 5.7.15 

Delete Command 5.7.15 

Delete Load Module Symbol 

Table Command 5.7.8 

Demonstration Test, Hardware 5.3 

Development Cycle, Prototype 1.2, Fl-1 

Diagram, Emulator/ Buffer Cabling .... F2-14 
Display and Modify 4.6.3.5, 7.9 

Command Characters T4-3 

Display, Instruction 4.6.3.2 

Display Load Module Symbol 

Table Command 5.7.7 

Display Register Command 5.7.5 

Display Statement 4.6.3 

Display System Symbol Table 

Command 5.7.9 

Display User Symbol Table 

Command 5.7.6 

Displaying: 

Target Memory 4.6.3.4 

Traced Addresses 7.8 

DIV Command 5.7.4 

Divide Command 5.7.4 

Documentation, Procedure DEBUG .... FH-4 

Documents, Related Preface 

DR Command 5.7.5, 7.5 

DST, System Variable 4.6.3.2 

DT Procedure FH-3 

DUMP Command 5.6.2 

DXIO 1.1 

Model 990/ 10 Computer Chassis 
Configuration F2-9, F2-10 

Prototyping Laboratory Peripherals . . F2-25 

System Generation Appendix B 



System: 

Loading 5.2.2 

Starting 5.2.2 

EB, Procedure FH-10 

EBRK Command 3.1.1,3.3,5.10.2,7.5, 

7.7, 7.10 

ECMP Command 3.1.1,3.3,5.10.4,7.5, 

7.7, 7.9, 7.10 

EDIT Command 5.7.13 

EDUMP Procedure FH-5 

EEVT Command .. 3.1.1,3.3,5.10.3,7.5.7.10 
EHTL Command .... 3.1.1, 3.2.1, 3.2.2, 3.2.3, 

3.2.4, 5.10.7 
EINT Command . 3.1.1,3.2.1,3.2.3,5.10.1,7.3 

Elements, Language 4.2 

EMT, System Variable 5.10 

Emulator Cable Connections F2-16 

Emulator Control: 

Commands 3.1.1 

Variables 3.1.1 

Emulator: 

Module F2-15 

Operation 7.5 

Emulator Operation Commands 5.10 

Emulator Status T5-1 

Emulator Trace Breakpoint F3-2 

Emulator Tracing 7.6 

Emulator-Trace Module 

Interconnections 2.2.3.4, F2-23 

Emulator/ Buffer: 

Cables 2.2.3.1 

Cabling Diagram F2-14 

Interconnection F2-3 

ENI, System Variable 5.10.2.1 

Enter Text Editor Command 5.7.13 

Entering Commands 5.5 

EOF Command 5.9.3 

Error message T6-1 

Formats 6.2 

Introduction 6.1 

ERUN Command .... 3.1.1, 3.2.1, 3.2.2, 3.2.3, 
3.2.4, 3.3, 3.4, 5.10.6, 7.5, 7.6, 7.9, 7.10 

ESCAPE Statement 4.6.10 

EST System Variable 3.1.1, 5.10.6.1 

ESTAT Procedure .... 3.1.1, 3.2.1, 3.2.2, 3.2.3, 

3.2.4, 3.3, FH-13 

ETB Command 4.7.7, 5.10.8 

ETBN System Variable ... 3.1.1, 4.7.7, 5.10.8.2 
ETBO System Variable ... 3.1.1, 4.7.7, 5.10.8.1 
ETM System Variable .... 3.1.1, 4.5.5.4, 5.10, 

7.3, 7.5 
ETRC Command 3.1.1, 3.3, 5.10.5, 7.5, 7.7, 7.10 

EUM System Variable 3.1.1, 3.2.1, 3.2.4, 

4.5.5.4, 5.10, 7.3 
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Evaluation, Expression 4.5.6 

Event Modes T5-2 

Example: 

Function 4.7.7 

Indirect Addressing 4.5.5.4 

Introduction 7.1 

Procedure 4.7.7 

Program 7.2 

Listing F7-I 

Loading 7.3 

Target System Front End F3-8 

TDATA Printout F3-5 

TEDUMP Printout F3-7 

Trace probe 3.4, F3-9 

Examples, TMS 9980 3.5 

Execution: 

FOR Statement F4-5 

IF Statement F4-2 

REPEAT Statement F4-4 

WHILE Statement F4-3 

EXIT Command 5.7.19 

Expression Evaluation 4.5.6 

Expressions 4.5 

Features, Operational 1.3 

FIFO Counter Operation F3-6 

FNDBYT Function FH-6 

FNDWRD Function FH-7 

FOR Statement 4.6.8 

FOR Statement Execution F4-5 

Format 4.4 

Format Character: 

G 4.6.3.3 

I 4.6.3.2 

Format Specification 4.6.3.1 

Characters T4-2 

Format Specifications, Altering 4.6.3.3 

Formats, Error Message 6.2 

Formula, Instruction Timing 4.6.3.2 

Front End, Example Target System .... F3-8 

FUNC Statement 4.7.2 

Function Calls 4.7.6 

Function Definition Statement 4.7.2 

Function: 

Example 4.7.7 

FNDBYT FH-6 

FNDWRD FH-7 

GETCHR FH-2 

INTR FH-9 

Library 4.7, Appendix H, TH-1 

G Format Character 4.6.3.3 

GETCHR Function FH-2 

Glossary Appendix I 

Grammer, AM PL Appendix C 



HALT Procedure FH-3 

Hardware: 

Demonstration Test 5.3 

Installation, System 5.8.3 

HCRB, System Variable 5.8.3 

HCRR Command 5.8.3 

HCRW Command 5.8.4 

HELP: 

Key 5.5 

Procedure FH-3 

Hexadecimal Constants 4.2.2.2 

Hierarchy of Operations T4-1 

HIST, Procedure FH-8 

Host CRU Read Command 5.8.3 

Host CRU Write Command 5.8.4 

HR, System Variable 5.5 

I Format Character 4.6.3.2 

IF Statement 4.6.4 

Execution F4-2 

Indirect: 

Addressing Example 4.5.5.4 

Operator 4.5.5.4 

Initial: 

Checks 3.2 

Debugging 7.4 

Initialize Compare Logic Command . . . 5.10.4 

Initialize Emulator Command 5.10.1 

Initialize Trace Compare 

Logic Command 5.11.4 

Initialize Trace Logic Command 5.10.5 

Initialize Trace Module Command .... 5.11.1 

Initialize Trace Module 
Trace Logic Command 5.1 1.5 

INITRM Procedure FH-2 

Installation: 

Circuit Board 2.2.2 

Computer 2.2.1 

System Hardware 2. 1 

INSTR Procedure FH-3 

Instruction: 

Constants 4.2.2.6 

Display 4.6.3.2 

Timing Formula 4.6.3.2 

Interconnection, Emulator/ Buffer F2-3 

Interconnections, Emulator-Trace 

Module 2.2.3.4, F2-23 

Interrupt: 

Connection Modification 2.2.1.2 

Jumper Plug Location F2-12 

Jumper Plugs F2-13 

Levels 2.2.1.1 

INTR Function FH-9 

Introduction 1.1 

AM PL Language 3.1. 4.1 
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Error Message 6.1 

Example 7.1 

System Operation 5.1 

Jumper Plug Location, Interrupt F2-12 

Jumper Plugs, Interrupt F2-13 

Key: 

CMD 5.5 

HELP 5.5 

Keywords, Alternate Qualifier T5-3 

Language Elements 4.2 

Leads, Data Probe Terminator and .... F2-21 

Levels, Interrupt 2.2.1.1 

Library, AMPL Procedure and 

Function Appendix H, F3-4, TH-I 

LIST Command 3.1.2, 5.7.2 

Listing, Example Program F7-1 

LOAD Command 5.6.1, 7.3 

Load Module Symbols 4.2.3.3, 5.6.1 

Loading: 

DXIO System 5.2.2 

Example Program 7.3 

TX990 System 5.2.1 

LOADUP Procedure FH-3 

LOC Operator 4.7.4 

Local Storage 4.7.4 

Location, Interrupt Jumper Plug F2-12 

Logical Operators 4.5.3 

Mapping, Target Memory 

Address 4.5.5.4, F4-1 

MC, System Variable 4.6.3.2, 4.7.7 

MDEL Command 5.7.8 

MDR, System Variable .... 4.5.6, 5.7.3, 5.7.4 

Memory Checkout, Target System 3.2.4 

Messages: 

Error T6-1 

Warning T6-1 

Microprocessor Command, Stop 5.10.7 

MIN, System Variable 5.5 

Model 990/4 Computer Chassis 

Configuration TX990 F2-5, F2-7 

Model 990/ 10 Computer Chassis 

Configuration: 

DXIO F2-9, F2-10 

TX990 F2-6, F2-9 

Modes, Event T5-2 

Modification, Interrupt Connection .... 2.2.1.2 

Module, Emulator F2-15 

Monitoring Program Execution 7.7 

MPY Command 5.7.3 

MREAD Procedure FH-3 

MSYM Command 5.7.7 



Multiply Command 5.7.3 

MWRITE Procedure FH-3 

Negation 4.5.5.2 

New Line Command 5.7.17 

NL Command 5.7.17 

Notation 4.3 

NULL Statement 4.6.11 

Octal Constants 4.2.2.3 

One's Complement 4.5.5.3 

OPEN Command 5.9.1 

Operation: 

Emulator 7.5 

FIFO Counter F3-6 

Introduction, System 5.1 

Trace Module 7.10 

Operational Features 1.3 

Operations, Hierarchy of T4-1 

Operator: 

ARG 4.7.3 

Indirect 4.5.5.4 

LOC 4.7.4 

Operators: 

Arithmetic 4.5.2 

Logical 4.5.3 

Relational 4.5.4 

Unary 4.5.5 

Peripherals: 

DXIO, Prototyping Laboratory . . 2.3, F2-25 
TX990, Prototyping Laboratory . 2.3, F2-25 

Plus, Unary 4.5.5.1 

Power, Restoring 5.4 

Printout, Example: 

TDATA F3-5 

TEDUMP F3-7 

PROC Statement 4.7.1, 7.9 

Procedure: 

AMPHDT 5.3, FH-I 

Library, AMPL Appendix H 

AT FH-3 

BL FH-9 

BLWP FH-9 

Calls 4.7.6 

CB FH-10 

DEBUG Documentation FH-4 

Definition Statement 4.7.1 

DELAY FH-3 

DT FH-3 

EB FH-10 

EDUMP FH-5 

ESTAT 3.1.1, 3.2.1, 3.2.2, 3.2.3, 3.2.4, 

3.3, FH-13 
Example 4.7.7 
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HALT FH-3 

HELP FH-3 

HIST FH-8 

INITRM FH-2 

INSTR FH-3 

Library F3-4 

LOADUP FH-3 

MREAD FH-3 

MWRITE FH-3 

PUTCHR FH-2 

Recovery 5.4 

RT FH-9 

RTWP FH-9 

RUN FH-3 

SB FH-10 

SETMEM FH-11 

SIE FH-12 

STAT FH-3 

TDATA 3.L2, 3.3, FH-14 

TDUMP FH-5 

TEDUMP 3.3, FH-5 

TFOUR FH-14 

TILL FH-3 

TIMER FH-15 

TRACE FH-3, FH-16 

TSAVE FH-17 

TSTAT 3.L2, 3.3, FH-13 

TVRFY FH-17 

VALUE FH-3 

XOP FH-9 

Procedures and Functions 4.7 

Procedures and Functions, Library TH-1 

Program: 

Commands 5.6 

Example 7.2 

Execution, Monitoring 7.7 

Listing, Example F7-1 

Results, Checking 7.9 

Prototype Development Cycle 12, Fl-I 

Prototyping Laboratory: 

Application 3.3 

Peripherals 2.3 

DXIO F2-25 

TX990 F2-24 

PUTCHR Procedure FH-2 

Qualifier: 

Keywords, Alternate T5-3 

QO 3.5 

QO, Qualifier 3.5 

READ Command 5.9.2 

CRU 5.8.1 

Read High Order Trace Module 
Memory Command 5.1 1.9 



Read Low Order Trace Module 

Memory Command 5.11.8 

Read Trace Memory Command 5.10.8 

Recovery Procedure 5.4 

Reference, Array 4.6.2 

Related Documents Preface 

Relational Operators 4.5.4 

REPEAT Statement 4.6.7, 7.7, 7.8 

Repeat Statement Execution F4-4 

Reserved Words, AM PL Appendix E 

Restore Test Environment Command . . 5.7.12 

Restoring Power 5.4 

Results, Checking Program 7.9 

RETURN Statement 4.7.5 

RSTR Command 5.7.12 

RT Procedure FH-9 

RTWP Procedure FH-9 

RUN Procedure FH-3 

SAVE Command 5.7.10 

Save Test Environment Command .... 5.7.10 

SB Procedure FH-10 

SEC, System Variable 5.5 

Select Event Command 5.10.3 

Select Trace Event Command 5.11.3 

Set, Character 4.2. 1 

SETMEM, Procedure FH-1 1 

SIE Procedure FH-12 

Size, Symbol Table 5.7.1 1 

Software Configuration 1.4 

SRC, System Variable 4.6.3.2 

SSYM Command 5.7.9 

Start Microprocessor Command 5.10.6 

Start Trace Command 5.11.6 

Starting: 

DXIO 5.2.2 

TX990 5.2.1 

STAT Procedure FH-3 

Statement: 

Array 4.6. 1 

Assign 4.6.2 

Compound 4.6.9, 7.4 

Display 4.6.3 

ESCAPE 4.6.10 

FOR 4.6.8 

FUNC 4.7.2 

Function Definition 4.7.2 

IF 4.6.4 

NULL 4.6.11 

PROC 4.7.1. 7.9 

Procedure Definition 4.7.1 

REPEAT 4.6.7, 7.7, 7.8 

RETURN 4.7.5 

Summary, AMPL Appendix D 

WHILE 4.6.6, 7.6, 7.10 
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Statements 4.6 

Status: 

Emulator T5-1 

Trace Module T5-4 

Stop Microprocessor Command 5.10.7 

Stop Trace Command 5.1 1.7 

Storage, Local 4.7.4 

Strings, Character 4.2.5 

Subexpressions 4.5.1 

Summary, AMPL Statement .... Appendix D 

Symbol Table Size 5.7.11 

Symbols 4.2.3 

Load Module 4.2.3.3, 5.6.1 

System 4.2.3.2, Appendix F 

User 4.2.3.1 

System: 

Components 2.1.2, T2-1 

Configuration 2.1.1, F 1-2, F2-2 

Connections: 

Target 2.2.3.2, F2-22 

TMS 9900 F2-17 

TMS9980 F2-18 

System Generation: 

DXIO Appendix B 

TX990 Appendix A 

System: 

Hardware Installation 2.1 

Loading 5.2 

DXIO 5.2.2 

TX990 5.2.1 

Operation Introduction 5.1 

Starting 5.2 

DXIO 5.2.2 

TX990 5.2.1 

Symbols 4.2.3.2, Appendix F 

System Variable: 

CC 4.6.3.2, 4.7.7 

CRUB 5.8.1 

DAY 5.5 

DST 4.6.3.2 

EMT 5.10 

ENI 5.10.2.1 

EST 3.1.1, 5.10.6.1 

ETBN 3.1.1, 4.7.7, 5.10.8.2 

ETBO 3.1.1,4.7.7,5.10.8.1 

ETM 3.1.1, 4.5.5.4, 5.10, 7.3, 7.5 

EUM 3.1.1, 3.2.1, 3.2.4, 4.5.5.4, 

5.10, 7.3 

HRCB 5.8.3 

HR 5.5 

MC 4.6.3.2, 4.7.7 

MDR 4.5.6, 5.7.3, 5.7.4 

MIN 5.5 

SEC 5.5 

SRC 4.6.3.2 



TIME 4.6.3.2, 4.7.7 

TNE 5.11.2.1 

TNI 5.11.2.2 

TST 3.1.2, 5.11.6.1 

TTBN 3.1.2,5.11.8.2 

TTBO 3.1.2, 5.11.8.1 

YR 5.5 

Target Memory: 

Address Mapping 4.5.5.4, F4-1 

Displaying 4.6.3.4 

Target System: 

Address and Data Bus Checkout 3.2.2 

Clock Checkout 3.2.3 

Connections 2.2.3.2, F2-22 

Connections TMS 9900 F2-17 

Connections TMS 9980 F2-18 

Front End, Example F3-8 

Memory Checkout 3.2.4 

TBRK Command .. 3.1.2,3.3,3.4,5.11.2,7.10 

TCMP Command 3.3, 3.4, 5.1 1.4 

TDATA: 

Printout Example F3-5 

Procedure 3.1.2, 3.3, FH-14 

TDUMP Procedure FH-5 

TEDUMP: 

Printout Example F3-7 

Procedure 3.3. FH-5 

Terminal Executive 1.1 

Terminal Executive Development 

System 1.1 

Terminate AMPL Program Command . 5.7.19 
Terminator and Leads, Data Probe .... F2-21 

Test, Hardware Demonstration 5.3 

TEVT Command 3.3, 3.4, 5.1 1.3 

TFOUR Procedure FH-14 

THLT Command 5.11.7 

TILL Procedure FH-3 

TIME, System Variable 4.6.3.2, 4.7.7 

TIMER Procedure FH-15 

Timing Formula, Instruction 4.6.3.2 

TINT Command 3.1.2, 5.11.1, 7.10 

TMS 9900, Target System 

Connections F2-17 

TMS 9980: 

Examples 3.5 

Target System Connections F2-18 

Trace Memory Contents F5-3 

TNE, System Variable 5.11.2.1 

TNI, System Variable 5.11.2.2 

Trace Breakpoint, Trace Module F3-3 

Trace Memory Contents F5-2 

TMS 9980 F5-3 

Trace Module F2-4 

Cables F2-4 
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Commands 3.1.2 

Connections 2.2.3.3, F2-20, F5-1 

Operation 7.10 

Operation Commands 5.1 1 

Status T5-4 

Trace Breakpoint F3-3 

Variables 3.1.2 

Trace Module-Emulator 

Interconnections 2.2.3.4, F2-23 

Trace Probe Example 3.4, F3-9 

TRACE Procedure FH-3, FH-16 

Traced Addresses. Displaying 7.8 

Tracing, Emulator 7.6 

TRUN Command 3.3,3.4,5.11.6,7.10 

TSAVE Procedure FH-I7 

TST System Variable 3. 1 .2, 5. 1 1 .6. 1 

TSTAT Procedure 3.1.2, 3.3, FH-13 

TTB Command 5.11.8 

TTBH Command 5.11.9 

TTBN, System Variable 3.1.2, 5.11.8.2 

TTBO, System Variable 3. 1.2, 5.1 1.8. 1 

TTRC Command .. 3.1.2,3.3,3.4,5.11.5,7.10 

TVRFY Procedure FH-17 

TXDS 1.1 

TX990 1.1 

Model 990/4 Computer Chassis 

Configuration F2-5, F2-7 

Model 990/ 10 Computer Chassis 

Configuration F2-6, F2-9 

Prototyping Laboratory 

Peripherals F2-24 



System Generation Appendix A 

System: 

Loading 5.2.1 

Starting 5.2.1 

Unary; 

Operators 4.5.5 

Plus 4.5.5.1 

User: 

Commands Appendix G 

Symbols 4.2.3,1 

USYM Command 5.7.6 

Utility Commands 5.7 

VALUE Procedure FH-3 

Variables: 

Emulator Control 3.1.1 

Trace Module 3.1.2 

Verify Command 5.7.18 

VRFY Command 5.7.18 

WAIT Command 5.7.16 

Warning Messages T6-I 

WHILE Statement 4.6.6, 7.6, 7.10 

Execution F4-3 

Words, AMPL Reserved Appendix E 

XOP Procedure FH-9 

YR, System Variable 5.5 
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